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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org ). 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI Technical Committee Smart Card Platform (SCP). 

The contents of the present document are subject to continuing work within TC SCP and may change following formal 
TC SCP approval. If TC SCP modifies the contents of the present document, it will then be republished by ETSI with 
an identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

early working draft; 

1 presented to TC SCP for information; 

2 presented to TC SCP for approval; 

3 or greater indicates TC SCP approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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Scope 



The present document covers the minimum characteristics considered necessary in order to provide compliance to 
TS 102 705 [1]. 

It specifies conformance test cases for the UICC Application Programming Interface for Java Card''''^ for contactless 
Applications. 



2 References 

References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the 
reference document (including any amendments) applies. 

• In the case of a reference to a TC SCP document, a non specific reference implicitly refers to the latest version 
of that document in the same Release as the present document. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http://docbox.etsi.org/Reference . 

NOTE: While any hyperlinks included in this clause were valid at the time of publication ETSI cannot guarantee 
their long term validity. 

2.1 Normative references 

The following referenced documents are necessary for the application of the present document. 

[I] ETSI TS 102 705: "Smart Cards; UICC Application Programming Interface for Java Cai'd™ for 
Contactless Applications". 

[2] ISO/lEC 7816-3: "Identification cards - Integrated circuit cards - Part 3: Cards with contacts - 

Electrical interface and transmission protocols". 

[3] ETSI TS 102 622: "Smart Cards; UICC - Contactless Front-end (CLF) Interface; Host Controller 

Interface (HCI)". 

[4] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication application 

providers". 

[5] ETSI TS 102 221: "Smart Cards; UICC-Terminal interface; Physical and logical characteristics". 

[6] ETSI TS 102 241 : "Smart Cards; UICC Application Programming Interface (UICC API) for Java 

Card(TM)". 

[7] ETSI TS 102 223: "Smart Cards; Card AppHcation Toolkit (CAT)". 

[8] ISO/lEC 9646-7: "Information technology - Open Systems Interconnection - Conformance testing 

methodology and framework - Part 7: Implementation Conformance Statements". 

[9] ETSI TS 102 226: "Smart Cards; Remote APDU structure for UICC based applications". 

[10] GlobalPlatform: "GlobalPlatform Card Specification Version 2.2, Amendment C: Contactless 

Services" Version 1.0. 

NOTE: See http://www. globalplatform.org/ . 

[II] Sun Microsystems "Application Programming Interface, Java Card"""^ Platform, 3.0.1 Classic 
Edition". 
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[12] Sun Microsystems "Runtime Environment Specification, Java CardT"^ Platform, 3.0.1 Classic 

Edition". 

[13] Sun Microsystems "Virtual Machine Specification Java CardT^ Platform, 3.0.1 Classic Edition". 

NOTE: SUN Java Card Specifications can be downloaded at 

http://www.oracle.com/technetwork/iava/iavame/iavacard/download/overview/index.html . 

[14] ETSI TS 102 613: "Smart Cards; UlCC - Contacdess Front-end (CLE) Interface; Part 1: Physical 

and data link layer characteristics". 

2.2 Informative references 

The following referenced documents are not necessary for the application of the present document but they assist the 
user with regard to a particular subject area. 

Not applicable. 



3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

applet installation parameters: values for applet installation parameters in the Install(Install) command 

Conformance Requirement Reference (CRR): description of the expected HCI API behaviour according to 
TS 102 705 [1] 

contactless mode: is used as a generic term for "Card Emulation Mode" and "Reader Mode" 

HCP message: message as specified in TS 102 622 [3] 

NOTE: An HCP message can be of type "command", "event" or "response to a command". 

test case: elementary test that checks for compliance with one or more Conformance Requirement References 

test procedure: sequence of actions/commands to perform all the test cases defined in a test area 

test source file: file containing methods that will load and install test applet in the card, execute and verify the test 
results, and restore the Default Initial Conditions on the UlCC (when possible) 

RF Technology: radio frequency technology supported by the HCI (TS 102 622 [3]) protocol specification 

3.2 Symbols 

For the purposes of the present document, the symbols given in TS 102 705 [1] apply. 

3.3 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

AID Application IDentifier 

APDU Application Protocol Data Unit 

NOTE: According to ISO/lEC 7816-3 [2]. 

API Application Programming Interface 

CAT Card Application Toolkit 
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CB 
CLF 



Chaining Bit 
Contactless Front-end 



NOTE: According to TS 102 622 [3]. 

CRR Conformance Requirements Reference 

CRRC Conformance Requirement Reference Context Error 

CRRN Conformance Requirement Reference Normal 

CRRP Conformance Requirement Reference Parameter Error 

CRS Contactless Registry Services 

DUT Device Under Test 

EVT EVenT 

FFS For Further Study 

GND GrouND 

HCl Host Controller Interface 

NOTE: According to TS 102 622 [3]. 

HCP Host Controller Protocol 

NOTE: According to TS 102 622 [3]. 



INS 

ISO 

JCRE 

RF 

SAA 

SDK 

sw 

SWP 
TAR 
TBD 



INStruction 

International Organisation for Standardisation 

Java Card'^ Run-time Environment 

Radio Frequency 

Service Availability and Access possibility for the different services 

Software Development Kit 

Status Word 

Single Wire Protocol 

Toolkit Application Reference 

To Be Defined 



3.4 



Formats 



3.4.1 Format of the table of optional features 

The columns in table 4.1 have the following meaning. 



Column 


Meaning 


Option 


The optional feature supported or not by the DUT. 


Status 


See clause 3.4.3. 


Support 


The support columns are to be filled in by the supplier of the implementation. The following common 
notations, defined in ISO/IEC 9646-7 [8], are used for the support column in table 4.1 . 
Y or y supported by the implementation. 
N or n not supported by the implementation. 

N/A, n/a or - no answer required (allowed only if the status is N/A, directly or after evaluation of a 
conditional status). 


Mnemonic 


The mnemonic column contains mnemonic identifiers for each item. 
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3.4.2 Format of the applicability table 

The applicability of every test in table 4.2 is formally expressed by the use of Boolean expression defined in the 
following clause. 

The columns in table 4.2 have the following meaning. 



Column 


Meaning 


Clause 


The "Clause" column identifies the clause containing the test case referenced in the "Test case 
number and description" column. 


Test case number 
and description 


The "Test case number and description" column gives a reference to the test case number (along 
with the corresponding description) detailed in the present document and required to validate the 
DUT 


Release 


The "Release" column gives the Release applicable and onwards, for the corresponding test case. 


Execution 
requirements 


The usage of the "Execution requirements" column is described in clause 4.4. 


Rel-x UICC 


For a given Release, the corresponding "Rel-x UICC" column lists the tests required for a DUT to be 
declared compliant to this Release. 


Support 


The "Support" column is blank in the proforma, and is to be completed by the manufacturer in 
respect of each particular requirement to indicate the choices, which have been made in the 
implementation. 



3.4.3 Status and Notations 

The "Rel-x" columns show the status of the entries as follows: 

The following notations, defined in ISO/IEC 9646-7 [8], are used for the status column: 

M mandatory - the capability is required to be supported. 

O optional - the capability may be supported or not. 

N/A not applicable - in the given context, it is impossible to use the capability. 

X prohibited (excluded) - there is a requirement not to use this capability in the given context. 

O.i qualified optional - for mutually exclusive or selectable options from a set. "i" is an integer which 

identifies an unique group of related optional items and the logic of their selection which is 
defined immediately following the table. 

Ci conditional - the requirement on the capability ("M", "O", "X" or "N/A") depends on the support 

of other optional or conditional items, "i" is an integer identifying an unique conditional status 
expression which is defined immediately following the table. For nested conditional expressions, 
the syntax "IF ... THEN (IF ... THEN ... ELSE...) ELSE ..." is to be used to avoid ambiguities. 

References to items 

For each possible item answer (answer in the support column) there exists a unique reference, used, for example, in the 
conditional expressions. It is defined as the table identifier, followed by a solidus character "/", followed by the item 
number in the table. If there is more than one support column in a table, the columns are to be discriminated by letters 
(a, b, etc.), respectively. 

EXAMPLE: 4. 1/4 is the reference to the answer of item 4 in table 4. 1 . 
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4 Applicability 

4.1 Table of optional features 

The device supplier shall state the support of possible options in table 4.1. See clause 3.4 for the format of table 4.1. 

Table 4.1 : Options 



Item 


Option 


Status 


Support 


Mnemonic 


1 


Card emulation, Type A 







CE TYPE A 


2 


Card emulation, Type B 







CE TYPE B 


3 


Card emulation. Type B' 







CE TYPE B PRIME 


4 


Card emulation. Type F 







CE TYPE F 


5 


Reader Mode, Type A 







RM TYPE A 


6 


Reader Mode, Type B 







RM TYPE B 


7 


HCP message size greater than supported buffer size 







MSG GT BUF 



4.2 Applicability table 

Table 4.2 specifies the applicability of each test case to the device under test. See clause 3.4 for the format of table 4.2. 

Clause 4.4 should be referenced for usage of the execution requirements which are referenced in table 4.2 a) and 
described in table 4.2 c). 

Table 4.2 a): Applicability of tests 



Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.1.1.1 


Method getHCIService (ID2, ID4) 


Rel-9 


SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-1) 


Rel-9 


SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.1.1 


Method getHCIService (ID1-3) 


Rel-9 


SAAS 


M 




6.1.1.1 


Method getHCIService (ID3-1) 


Rel-9 


SAA6 


M 




6.1.1.1 


Method getHCIService (ID3-2) 


Rel-9 


SAA7 


M 




6.1.1.1 


Method getHCIService (ID3-3) 


Rel-9 


SAAS 


M 




6.1.1.1 


Method getHCIService (ID5-1) 


Rel-9 


SAA4 


M 




6.1.1.1 


Method getHCIService (ID5-2) 


Rel-9 


SAAS 


M 




6.1.1.2 


Method getPowerMode (ID1, ID2) 


Rel-9 


SAA1 


M 




6.1.1.2 


Method getPowerMode (IDS) 


Rel-9 




M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-1, ID3-1) 


Rel-9 


SAA1 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID1-3) 


Rel-9 


SAAS 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID2) 


Rel-9 




M 




6.1.1.3 


Method IsHCIServiceAvailable (ID3-2) 


Rel-9 


SAAS 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID4-1) 


Rel-9 


SAA4 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID4-2) 


Rel-9 


SAAS 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID5-1) 


Rel-9 


SAA10 


M 




6.1.1.3 


Method IsHCIServiceAvailable (ID5-2) 


Rel-9 


SAA11 


M 




6.1.2.1 


Method register (ID1-1, ID2, ID3, ID4) 


Rel-9 


SAA1 


M 




6.1.2.1 


Method register (ID1, ID2, ID3-1, ID4) 


Rel-9 


SAA1 


M 




6.1.2.1 


Method register (ID1-2, ID3-2) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.1 


Method register (ID1 -3, ID3-3) 


Rel-9 


SAAS 


M 




6.1.2.2 


Method deregister(ID1-1, ID1-3) 


Rel-9 


SAA1 


M 




6.1.2.2 


Method deregister (ID1-2, ID2) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.3 


Method activateEvent (ID1, ID4, ID6, ID7, IDS, ID9, 
ID10) 


Rel-9 


SAA1 


M 




6.1.2.3 


Method activateEvent (ID2) 


Rel-9 


SAAS 


M 
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Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.1.2.3 


Method activateEvent (ID3) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.3 


Method activateEvent (ID5-1) 


Rel-9 


SAA10 


M 




6.1.2.3 


Method activateEvent (ID5-2) 


Rel-9 


SAA11 


M 




6.1.2.4 


Method deactivateEvent (ID1, ID4, ID5) 


Rel-9 


SAA1 


M 




6.1.2.4 


Method deactivateEvent (ID2, ID7) 


Rel-9 


SAA3 


M 




6.1.2.4 


Method deactivateEvent (ID3, ID6) 


Rel-9 


SAA1, 
SAA2 


M 




6.1.2.5 


Method requestCallbacl<Notification 


Rel-9 


SAA1 


M 




6.1.2.6 


Method getEventNotificationStatus(ID1, ID2, ID5-1) 


Rel-9 


SAA1 


M 




6.1.2.6 


Method getEventNotificationStatus(ID3,ID4, ID5-2) 


Rel-9 


SAA3 


M 




6.1.2.6 


Method getEventNotificationStatus(ID5-3, ID6, ID7) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.3.1 


Method isHeading 


Rel-9 


SAA1 


M 




6.1.3.2 


Method isComplete 


Rel-9 


SAA1 


M 




6.1.3.3 


Method getType(IDI) 


Rel-9 


SAA1 


M 




6.1.3.3 


Method getType (ID2) 


Rel-9 


SAA2, 
SAA1 


M 




6.1.3.4 


Method getlnstruction 


Rel-9 


SAA1 


M 




6.1.3.6 


Method getReceiveLength 


Rel-9 


SAA1 


M 




6.1.3.7 


Method getReceiveBuffer 


Rel-9 


SAA1 


M 




6.1.4.1 


Method throwit 


Rel-9 


SAA1 


M 




6.1.5.1 


Method onCallbacl< (ID1, ID2, ID3) 


Rel-9 


SAA1 


M 




6.1.5.1 


Method onCallbacl< (ID4) 


Rel-9 


SAA1 


C002 




6.1.5.1 


Method onCallbacl< (ID5) 


Rel-9 


SAA1 


C001 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID1) 


Rel-9 


SAA1 


C001 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID2) 


Rel-9 


SAA1 


C002 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID3-1) 


Rel-9 


SAA1 


C001 
C007 




6.2.1.1.1 


Method prepareAndSendGetParameterCommand 
(ID3-2) 


Rel-9 


SAA1 


C002 
C007 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (ID1) 


Rel-9 


SAA1 


C001 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (ID2) 


Rel-9 


SAA1 


C002 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (ID4, ID5) 


Rel-9 


SAA1 


M 




6.2.1.1.2 


Method prepareAndSendSendDataEvent (ID3) 


Rel-9 


SAA1 


C007 




6.2.1.1.3 


Method selectingMessage 


Rel-9 


SAA1 


M 




6.2.1.2.1 


Method getCardRFType (ID1) 


Rel-9 


SAA1 


C001 




6.2.1.2.1 


Method getCardRFType (ID2) 


Rel-9 


SAA1 


C002 




6.2.1.2.1 


Method getCardRFType (ID4) 


Rel-9 


SAA1 


C003 




6.2.1.2.1 


Method getCardRFType (ID3) 


Rel-9 


SAA1 


C004 




6.2.1.3.1 


Method onCallbacl< (ID1,ID2, ID3, ID5-2) 


Rel-9 


SAA1 


C001 




6.2.1.3.1 


Method onCallbacl< (ID4, ID5, ID6, ID5-3) 


Rel-9 


SAA1 


C002 




6.2.1.3.1 


Method onCallbacl< (ID5-1, ID5-4) 


Rel-9 


SAA1 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID1, 
ID3, ID4, ID5) 


Rel-9 


SAA2, 
SAA1 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID2-1) 


Rel-9 


SAA2, 
SAA1, 
SAA10 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID2-1) 


Rel-9 


SAA2, 
SAA1, 
SAA11 


M 




6.2.2.1.1 


Method prepareAndSendConnectivityEvent (ID6) 


Rel-9 


SAA2, 
SAA1, 
SAA9 


M 




6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) (ID1, ID3, ID4, ID5) 


Rel-9 


SAA1, 
SAA2 


M 




6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) (ID2-1) 


Rel-9 


SAA2, 
SAA10 


M 
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Clause 


Test case number and description 


Release 


Execution 
requirements 


Rel-9 
UICC 


Support 


6.2.2.1.2 


Method prepareAndSendTransactionEvent 
byte[] aid, short aidOffset, short aidLen, 
byte[] parameters, short parametersOffset, 
short parametersLen) (ID2-2) 


Rel-9 


SAA2, 
SAA11 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID1, 1D3, ID4) 


Rel-9 


SAA2 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID2-1) 


Rel-9 


SAA2, 
SAA10 


M 




6.2.2.1.3 


Method prepareAndSendTransactionEvent 
(byte[] parameters, short parametersOffset, 
short parametersLen ) (ID2-2) 


Rel-9 


SAA2, 
SAA11 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID1) 


Rel-9 


SAAS 


COOS 




6.2.3.1.1 


Method restartReaderModeProcedure (ID2) 


Rel-9 


SAAS 


C006 




6.2.3.1.1 


Method restartReaderModeProcedure (IDS, ID4) 


Rel-9 


SAAS 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID5-1) 


Rel-9 


SAAS, 
SAA10 


M 




6.2.3.1.1 


Method restartReaderModeProcedure (ID5-2) 


Rel-9 


SAAS, 
SAA11 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID1) 


Rel-9 


SAAS 


COOS 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID2) 


Rel-9 


SAAS 


C006 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID4, IDS, 1D6, ID7) 


Rel-9 


SAAS 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID3-1) 


Rel-9 


SAAS, 
SAA10 


M 




6.2.3.1.2 


Method prepareAndSendWriteXchgDataCommand 
(ID3-2) 


Rel-9 


SAAS, 
SAA11 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID1) 


Rel-9 


SAAS 


COOS 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID2) 


Rel-9 


SAAS 


C006 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID3-1) 


Rel-9 


SAAS, 
SAA10 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID3-2) 


Rel-9 


SAAS, 
SAA11 


M 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(ID4) 


Rel-9 


SAAS 


C007 




6.2.3.1.3 


Method prepareAndSendGetParameterCommand 
(IDS) 


Rel-9 


SAAS 


M 




6.2.3.2.1 


Method onCallback 


Rel-9 


SAAS 


M 




6.2.3.2.1 


Method onCallbacl< (ID1, ID2, IDS, ID4) 


Rel-9 


SAAS 


COOS 




6.2.3.2.1 


Method onCallbacl< (IDS, ID6, ID7, IDS) 


Rel-9 


SAAS 


C006 





Table 4.2 b): Conditional items referenced by table 4.2 a) 



Conditional item 


Description 


C001 


IF CE TYPE A THEN M ELSE N/A 


C002 


IF CE TYPE B THEN M ELSE N/A 


COOS 


IFO CE TYPE B PRIME THEN M ELSE N/A 


C004 


IF CE TYPE F THEN M ELSE N/A 


COOS 


IF RM TYPE A THEN M ELSE N/A 


C006 


IF RM TYPE B THEN M ELSE N/A 


C007 


IF MSG GT BUF THEN M ELSE N/A 
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Table 4.2 c): Execution requirements referenced by table 4.2 a) 



Execution 
requirement 


Description 


SAA1 


Card emulation service is available 


SAA2 


Connectivity service is available 


SAA3 


Reader IVIode service is available 


SAA4 


Access not allowed for Applet for Card Emulation service 


SAA5 


Access not allowed for Applet for Reader service 


SAA6 


Card emulation service is not available 


SAA7 


Connectivity service is not available 


SAA8 


Reader Mode service not available 


SAA9 


Proactive functionalty in TS 1 02 241 [6] is supported 


SAA10 


Toolkit application is available and registered to the ENVELOPE (EVENT DOWNLOAD - Contactless 
state request) and allowed to switch on/off HCI interface 


SAA11 


No CRS on the card and test applet acting like CRS can be loaded 



4.3 Information provided by the device supplier 

The device supplier shall provide the information indicated in table 4.3. 

Table 4.3: Information provided by device suppliers 



Item 


Description 


Value 


Mnemonic 


1 


Presence of an application associated to an contactless applet that can be launched in the 
terminal host using EVT TRANSACTION 




AID, 
Parameters 


2 


Supported received message buffer size 







4.4 Execution requirements 



Table 4.2, Applicability of tests, specifies execution requirement (SAAn) for several test cases, to define the service 
availability and access possibility for the different services. For these test cases, the availability of the different services 
shall be guaranteed in order to execute the corresponding test procedure against the DUT. In case of absence of a 
particular (SAAn), the corresponding test case should not be carried out. 



Test environment 



This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 
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5.1 Test environment description 

The general architecture for the test envkonment is: 



Scope of the Test Suite. 



Elements of the Test Suite 



Test preparation 



Test HCI API 
applet 



^^, 



Applet ".cap" 



Applet 
Instalation 
parameter 



'h 



Test preparation 
tools 



Converter 



Loader 



Test Procedure 
exchiange 



HCI cmd/event 



HCIcmd/ •* 
response 



Terminal 
simulation 



HCI (TS 102 622) 



^ 



SWP(TS 102 613) 



Implementation Under Test (lUT) 



Apps relatec 
to the 
other 
interfaces 



CRS App 
CRELApp 



Card 

Emulation 
Mode 
Applets 



fj 

Reader 

Mode 

Applets 




Test 
Applets 



Java CarJ" 
package 



CRS API 



uicc.hci. framework 
package 



uicc.hci. service 
packages 



Java CarJ" Runtime Environment 



CL Registry 



Contactless 
Framework 



HCI (TS 102 622) 



SWP (TS 102 613) 



Figure 5.1 

5.2 Tests format 
5.2.1 Test area reference 

Each test area is referenced as follows: 

For HCI Framework and HCI services Testing: 'Api_[package name]_[class name]_[method name]' where 

• package name: 

uicc.hci.framework: '1'. 
uicc.hci. services: '2'. 

• class name: 

yyy: 3 letters for each class/interface. 

■ See annex A for full classes/interfaces acronyms list. 

• method name: 

zzz [input parameters] : 

■ See annex A for full methods name acronyms list. 
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5.2.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

• Method prototype as listed in TS 102 705 [1]. 

• Normal execution: 

Contains normal execution and correct parameters limit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

• Parameters error: 

Contains parameter errors and incorrect parameter limit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

• Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 



5.2.1.2 



Test suite files 



Each test suite files contains a table to indicate the correspondence between the applet names and the different test 
cases. 



Applet Name 


Test case ID 


[Test Area Reference] [Test applet number].java 


Test case 



The test applets and the related Cap Files use the following naming convention: 

• Test Applet: [Test Area Reference]_[Test applet number] Java 

• Cap File: [Test Area Reference]. cap 
The applet numbers start from '1'. 

The Cap File format is described in Java Card^"^ Virtual Machine Specification [13]. 
All files from the same test area are located in the same subfolder. 



5.2.1.3 



Initial conditions 



In addition to the general precondtions defined in clause 5.3, this clause defines the initial conditions prior to the 
execution of each test case; i.e. for each ID. 

5.2.1 .4 Test procedure 

Each test procedure contains a table to indicate the expected responses form the API and APDU as follows. 



Test Case 


Id 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




Commands sent on 
HCI interface 


Test Case detailed 
description 


API expected 
behaviour 


Expected behaviour at 
APDU/HCI level 


Conformance 
Requirements Reference 
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5.3 



Initial con(ditions 



The Initial Conditions are a set of general prerequisites for the UICC prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

• unless otherwise stated, before installing the applet(s) relevant to the current test procedure, all packages 
specific to other test procedures shall not be present. 

Prior to any test the test environment shall have the UICC powered on and performed the session initialization and RF 
registries updates as described in TS 102 622 [3]. The test can be executed once the HCI interface is idle; i.e. no further 
communication is expected. 



5.4 Package name 



Java packages integrating this Test Suite shall follow this naming convention: 

uicc.hci.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the 
TS 102 705 [1] uicc.hci. framework package. 

uicc.hci.test.services.cardemulation.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services. cardemulation package. 

uicc.hci.test.services.connectivity.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services. connectivity package. 

uicc.hci.test.services.readerniode.[Test Area Reference]: Java Card packages containing Test Area References for 
the TS 102 705 [1] uicc. hci. services. readermode package. 

where the Test Area Reference is written in lower case. 

EXAMPLE: The package ../uicc.hci. test.framework.[Test Area Reference] creates the following directory 
structure ../uicc/hci/test/framework/[TestArea Reference] /Api_l_..._[l..n].'*, where 
Api_l_..._[l..n].'*' are the different test applets Java source files used in [Test Area Reference] . 



5.5 AID coding 



The AID coding for the Test Packages, Applet classes and Applets shall be as specified in TS 101 220 [4]. In addition, 
the following TAR and Application Provider specific data values are defined for use within the present document: 

AID coding 

Byte1 \ I Byte 12 | Byte 13 | Byte 14 | Byte 15 | Byte 16 | 



Application Provider specific data 



TAR 



Specified in TS 101 220 [4] 



TAR coding (3 bytes / 24 bits): 




b8 b9 



b16 



b17 



b24 



Applet class/instance number 



Package number 



Core package identifier 



Test Part Identifier 
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Applet instance number, Applet Class number, Package number: 

• For package AID, package number shall start from and class and instance numbers shall be 0. 

• For class AID, package number is the number of the class package, class number shall start from 1 and 
instance shall be 0. 

• For instance AID, package and class number are the number of class and package of which instance belongs, 
and instance number shall start from 1. 

Test Part and Core Package Identifier 

• 0000 0000 reserved (as TAR= '00.00.00' is reserved for Issuer Security Domain). 

• 0010 0001 uicc.hci. test. framework. 

• 0010 0100 uicc.hci. test. servces. 

• 0010 0101 uicc.hci. test. services.cardemulation. 

• 0010 0100 uicc.hci.test.servces. connectivity. 

• 0010 0100 uicc.hci. test. servces.readermode. 
Application Provider specific data (1 byte): 

• '00' for Package. 

• 'Or for Applet class. 

• '02' for Applet Instance. 
EXAMPLE: Annex B. 

5.6 Test equipment 

These clauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

5.6.1 Test tool 

This test tool shall meet the following requirements: 

be able to send and receive commands using the underlying HCI resources (e.g. gates and pipes) defined by 
the HCI protocol as specified in 102 622 [3]; 

be able to send and receive the commands correctly on the lower layer; i.e TS 102 613 [14]; 

the result of I/O commands shall be presented at the application layer; 

be able to provide results of the tests; 

shall send and/or compare all data specified in test file. 



5.6.2 Java Software Development Kit 



Java Card^*^ software development kit (SDK) version supported by Java Card 3.0.1 specifications ([11], [12], [13]) is 
1.5. 
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6 Test cases 

6.1 Package uicc.hci.framework 

6.1.1 Class HCIDevice 

6.1 .1 .1 Method getHCIService 

Test Area Reference: Api_l_Hdv_Gsr. 

6.1 .1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static HCIService getHCIService {short servicelD) 

throws HCIException, 

j avacard . framework . SystemException 



6.1.1.1.1.1 



Normal execution 



CRRNl: used to retrieve instances that implement one of HCIService subinterfaces defined in the present 
document. 

CRRN2: returns reference to the permanent JCRE entry point object of the HCIService. 

CRRN3: returns null if not yet registered. 



6.1.1.1.1.2 



Parameter errors 



• CRRPl : javacard.framework.SystemException is thrown with the reason code ILLEGAL_VALUE if the 
servicelD does not match with the predefined values. 



6.1.1.1.1.3 



Context errors 



CRRCl: HCIException thrown with reason HCI_ACCESS_NOT_GRANTED if access to the indicated 
service is not permitted for the Applet. 

CRRC2: HCIException is thrown with reason HCI_SERVICE_NOT_AVAILABLE if the requested service 
type is not available. 



6.1.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Gsr l.java 


1 


Api 1 Hdv Gsr 2.java 


2 


Api 1 Hdv Gsr l.java 


3 


Api 1 Hdv Gsr l.java 


4 


Api_1_Hdv_Gsr_1 .Java 


5 



6.1.1.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



£75/ 



(Release 9) 



21 



ETSI TS 103 115 V9.0.0 (2013-04) 



6.1.1.1.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


1 


Select supported and registered service 


1 - 


getHCIService {) 


No exception shall be thrown 


EVT SEND DATA 


N1, 




EVT SEND DATA 


servicelD = 




(SW - '90 00') 


N2 




(INS = '01') 


CARD_EMULATION_SERVICE_ID 








2- 


getHCIService {) 


No exception shall be thrown 


EVT SEND DATA 


N1, 




EVT SEND DATA 


servicelD = 




(SW - '90 00') 


N2 






CONNECTIVITY SERVICE ID 










(INS = '02') 










3 - Send command 


getHCIService {) 


No exception shall be thrown 


SW - '90 00' 


N1, 




on ISO interface; 


servicelD = 






N2 




the initial 


READER_SERVICE_ID 










conditions in 












clause 6.1.1.1.3 












not applicable here 












- select applet- 












INS= '03' 










2 


Applet not registered 


EVT SEND DATA 


Applet . register { ) has not 


Return: Null 


EVT SEND DATA 


N3 




(INS = '01') 


yet been invoked . 

getHCIService {) 

servicelD = 

CARD EMULATION SERVICE ID 




(SW - '90 00') 




3 


Select not availabile service 


1 - Send command 


getHCIService {) 


Shall throw 


SW - '90 01 ' 


C2 




on ISO interface; 


servicelD = 


uicc.hci. framework. HCI Except 








the initial 


CardEmulationService 


ion with error code 








conditions in 




HCI SERVICE NOT AVAILA 








clause 6.1.1.1.3 




BLE 








not applicable here 












- select applet- 












(INS = '01') 










2- 


getHCIService {) 


Shall throw 


EVT SEND DATA 


C2 




EVT SEND DATA 


servicelD = 


uicc.hci.framework.HCIExcept 


(SW-'90 01') 






(INS='02') 


Connect ivityService 


ion with error code 

HCI SERVICE NOT AVAILA 

BLE 






3 - Send command 


getHCIService {) 


Shall throw 


SW-'90 01' 


C2 




on ISO interface; 


servicelD = ReaderService 


uicc.hci.framework.HCIExcept 








the initial 




Ion with error code 








conditions in 




HCI SERVICE NOT AVAILA 








clause 6.1.1.1.3 




BLE 








not applicable here 












- select applet- 












(INS = '03') 










4 


Select undefined service 


EVT SEND DATA 


getHCIService {) 


Shall throw 


EVT SEND DATA 


PI 




(INS = '04') 


servicelD = -1 


javacard.framework.SystemE 
xception with error code 
ILLEGAL VALUE 


(SW - '90 00') 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


5 


Access not granted 


1 - Send command 


getHCIService {) 




Shall throw 


SW - '90 02' 


CI 




on ISO interface; 
the initial 


sevicelD = 
CardEmulationService 




uicc.hci.framework.HCIExcept 
ion with error code 








conditions in 






HCI ACCESS NOT GRANT 








clause 6.1.1.1.3 






ED 








not applicable here 
- select applet- INS 
= '01' 












2 - Send command 


getHCIService {) 




Shall throw 


SW - '90 02' 


CI 




on ISO interface; 
the initial 


servicelD = 
ReaderSevice 




uicc.hci.framework.HCIExcept 
Ion with error code 








conditions in 






HCI ACCESS NOT GRANT 








clause 6.1.1.1.3 






ED 








not applicable here 
- select applet- 
INS='03' 













6.1 .1 .2 Method getPowerMode 

Test Area Reference: Api_l_Hdv_Gpm. 

6.1 .1 .2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static byte getPowerMode { ) 

6.1.1.2.1.1 Normal execution 

• CRRNl: returns the current power mode of the UICC as defined in TS 102 613 [14]. 

• CRRN2: returns the current power mode or -1 if the power mode cannot be retrieved. 

• CRRN3: Applets communicating through the process() method shall also be able to use the API services 
defined in TS 102 705 [1] which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.1.1.2.1.2 


Parameter errc 


• None. 




6.1.1.2.1.3 


Context errors 


• None. 




6.1.1.2.2 


Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Gpm l.java 


1 


Api 1 Hdv Gpm l.java 


2 


Api_1_Hdv_Gpm_1 .Java 


3 



6.1 .1 .2.3 Initial conditions 

• The UICC is not powered up. 
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6.1.1.2.4 



Test procedure 



Test case 


ID 


HCI Command API Description API Expectation HCI Response CRR 


1 


Verify power mode 


- Activate the UICC in full power 
mode. 

- EVT FIELD ON 

- EVT CARD ACTIVATED 

- EVT_SEND_DATA (select 
applet) 

- EVT SEND DATA(INS='05') 


getPowerMode ( ) 


return = 
FULL_POWER_MODE 


EVT SEND DATA (SW - 
'90 03') 


N1, 
N3 


2 


Verify power mode 


Activate the UICC in low power 
mode. 

- EVT FIELD ON 

- EVT CARD ACTIVATED 

- EVT_SEND_DATA (select 
applet) 

- EVT SEND DATA(INS='05') 


getPowerMode ( ) 


return = 
LOW_POWER_MODE 


EVT SEND DATA (SW - 
'90 04') 


N1, 
N3 


3 


SWP interface is not activated 


sending command on ISO 

interface: 

- select applet- INS='05' 


getPowerMode ( ) 


Return '-1' 


SW - '90 05' 


N2 



6.1 .1 .3 Method isHCIServiceAvailable 

Test Area Reference: Api_l_Hdv_Isa. 

6.1 .1 .3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static byte isHCIServiceAvailable (short servicelD) 

6.1.1.3.1.1 Normal execution 

• CRRNl: this method is used to retrieve information about the availability of a HCIService more related to user 
interface. 

• CRRN2: this method returns (byte)OxOO if the service is available and can be used, otherwise bit values set to: 

bit set: interface not supported by terminal; 

bit 1 set: service not supported by terminal; 

bit 2 set: access not allowed for Applet; 

bit 3 set: HCI interface currently disabled in UICC. 



6.1.1.3.1.2 

• None. 

6.1.1.3.1.3 

• None. 



Parameter errors 



Context errors 
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Test suite files 



Applet Name 


Test case ID 


Api 1 Hdv Isa l.java 


1 


Api 1 Hdv Isa l.java 


2 


Api 1 Hdv Isa l.java 


3 


Api 1 Hdv Isa l.java 


4 


Api 1 Hdv Isa 2.java 


5 



6.1 .1 .3.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.1.3.4 



Test procedure 



Test Case 


ID 


HCI/APDU Command | API Description | API Expectation | HCI/APDU Response |CRR 


1 


Retrieve Information of an available service 


1 - EVT SEND DATA (INS 
= '06') 


isHCIServiceAvailable { ) 

servicelD = 

CARD_EMULATI ON_S ERVI CE_I D 


0x00 


EVT_SEND_DATA (SW - 
'90 00', data byte set to 
'00') 


N1, 
N2 


2 - EVT SEND DATA (INS 
= '07') 


isHCIServiceAvailable { ) 
servicelD = 
CONNECTIVITY_SERVICE_ID 


0x00 


EVT_SEND_DATA (SW - 
'90 00', data byte set to 
'00') 


N1, 
N2 


3 - Send command on ISO 
interface to select applet; 
the initial conditions in 
clause 6.1.3.1.3 not 
applicable here 
- send APDU INS='08' 


isHCIServiceAvailable { ) 
servicelD = 
READER SERVICE ID 


0x00 


SW - '90 00', data byte 
set to '00' 


N1, 
N2 


2 


Interface not supported by terminal 


Precondition: SWP 
interface not supported; the 
initial conditions in clause 
6.1.1.3.1.3 not applicable 
here, and C6 should be 
connected to GND: 

Sending command on ISO 
interface: 

- select applet 

- send APDU (INS = '06') 


isHCIServiceAvailable { ) 


bit set 


- SW - '90 00' 

- SW - '90 00', bit set in 
the data byte 


N2 
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Test Case 


ID 


HCI/APDU Command API Description API Expectation HCI/APDU Response CRR 


3 


Service not supported by terminal 


1 - Precondition: disable 
Connectivity service 
support in terminal; i.e. 
connectivity gate is not 
available in terminal pipe 
creation is not possible and 
the 

terminal shall indicate in 
TERMINAL PROFILE 
HCI Connectivity is not 
supported. 

- select applet 

- EVT SEND DATA (INS = 
'07') 


isHCIServiceAvailable { ) 
servicelD = 
CONNECTIVITY_SERVICE_ID 


bit 1 set 


EVT_SEND_DATA (SW - 
'90 00', bit 1 set in the 
data byte) 


N2 


2 - Precondition: disable 
Reader service support in 
terminal; i.e. reader RF 
gates are not available in 
terminal 

Send command on ISO 
interface to select applet; 
the initial conditions in 
clause 6.1.1.1.3 not 
applicable here 

- select applet 

- send APDU (INS='08') 


isHCIServiceAvailable { ) 
servicelD = 
READER_SERVICE_ID 


bit 1 set 


SW - '90 00', bit 1 set in 
the data byte 


N2 


4 


Access not allowed for Applet 


1 - Send command on ISO 
interface to select applet; 
the initial conditions in 
clause 6.1.1.1.3 not 
applicable here 

- select applet 

- send APDU (INS = '06') 


isHCIServiceAvailable { ) 

servicelD = 

CARD_EMULATI ON_S ERVI CE_I D 


bit 2 set 


SW - '90 00', bit 2 set in 
the data byte 


N2 


2 - Send command on ISO 
interface to select applet; 
the initial conditions in 
clause 6.1.1.1.3 not 
applicable here 

- select applet 

- send APDU (INS = '08') 


isHCIServiceAvailable { ) 
servicelD = 
READER_SERVICE_ID 


bit 2 set 


SW - '90 00', bit 2 set in 
the data byte 


N2 


5 


HCI Interface currently disabled In UICC 


1 - Precondition: 
Contactless functionality 
state is disabled in the 
UICC as defined in TS 102 
223 [7]. Send on ISO 
interface the following 
commands: 

- Send APDU to select the 
applet. 

- Send APDU (INS = '06') 


isHCIServiceAvailable { ) 


bit 3 set 


SW - '90 00', bit 3 set in 
the data byte 


N2 
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Test Case 


ID 


HCI/APDU Command 


API Description 


API Expectation 


HCI/APDU Response 


CRR 




2 - Precondition: 


setCommunicationlnterf ace { ) 


bit 3 set 


SW - '90 04', bit 3 set in 


N2 




Contactless functionality 
state is disabled in the 
UICC as defined in Global 
Platform Amendment C 


API method of Global 
Platform Amendment C [10] 
is used to disable HCI 
interface 




the data byte 






Send on ISO interface send 


isHCIServiceAvailable { ) 










the following commands: 

- Send APDU to select the 
applet. 

- Send APDU (INS = '06') 

- Postcondition: 
Contactless functionality 
state is enabled again in 


setCommunicationlnterf ace { ) 
API method of Global 
Platform Amendment C [10] 
is used to enable again HCI 
interface 










the UICC as defined in 












Global Platform 












Amendment C 











6.1.2 Interface HCIService 
6.1.2.1 Method register 

Test Area Reference: Api_l_Hsr_Reg. 

6.1 .2.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void register {HCIListener listener) 
throws HCIException 

6.1.2.1.1.1 Normal execution 

• CRRNl: registers a Listener object to the Service instance. 

• CRRN2: a certain listener type can only be registered to the same service type. 

• CRRN3: The Registration of Listener Interfaces and activation of events shall be persistent. 

6.1.2.1.1.2 Parameter errors 

• CRRPl: throws HCIException in case the listener Object registered to the service is not implementing the 
corresponding interface of the HCIService instance with error code: 

HCIException.HCI_WRONG_LISTENER_TYPE. 

6.1.2.1.1.3 Context errors 

• CRRCl : throws HCIException with error code HCI_LISTENER_ALREADY_REGISTERED in case a 
listener Object of the same type has already been registered. 
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Test suite files 



Applet Name 


Test case ID 


Api 1 Hsr Reg l.java 


1-1 


Api 1 Hsr Reg S.java 


1-2 


Api 1 Hsr Reg S.java 


1-3 


Api 1 Hsr Reg l.java 


2 


Api 1 Hsr Reg 2.java 


3-1 


Api 1 Hsr Reg 4.java 


3-2 


Api 1 Hsr Reg S.java 


3-3 


Api 1 Hsr Reg l.java 


4 



6.1.2.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.2.1.4 



Test procedure 





Test case 


ID 


HCI Command 


Description API Expectation HCI Response CRR 


1 


Register Listener to a service 


1 - 

EVT SEND DATA 

(INS = '09') 


register { ) 
Service = 

CarcJEmulationService 
Listener = 
CarcJEmulationListener 


No exception shall be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1 


2- 

EVT SEND DATA 

(INS = '09') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1 


3 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.1.3 not 
applicable here 
- send APDU 
(INS='09') 


register { ) 

Service = ReacJerService 

Listener = ReacJerListener 


No exception shall be thrown 


SW- '90 00' 


N1 


2 


Register wrong listener type 


EVT SEND DATA 
(INS = 'OA') 


register { ) 

Service = 

Connect ivityService 

Listener = 

CarcJEmulationListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI WRONG LISTENER TYP 

E 


EVT SEND DATA 
(SW- '90 00') 


N2, 
PI 


3 


Listener already registered 


1 - 

EVT SEND DATA 

(INS = 'OB') 


register { ) 
Service = 

CarcJEmulationService 
Listener = 
CarcJEmulationListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


EVT SEND DATA 
(SW- '90 00') 


CI 


2- 

EVT SEND DATA 

(INS = 'OB') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


Shall throw 

uicc.hci.framework.HCIExceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


EVT SEND DATA 
(SW- '90 00') 


CI 
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Test case 


ID 


HCI Command 


Description 


API Expectation 


HCI Response 


CRR 




3 - Send command 


register { ) 


Shall throw 


SW- '90 00' 


CI 




on ISO interface to 
select applet; the 


Service = ReaderService 
Listener = ReaderListener 


uicc.hci. framework. HCI Exceptio 
n with error code 








initial conditions in 




HCI LISTENER ALREADY RE 








clause 6.1.2.1.3 not 




GISTERED 








applicable here 
- send APDU 












(INS='OB') 










4 


Persistent Listener Registration 


-Send 


register { ) 


Shall throw 


EVT SEND DATA 


N3 




EVT SEND DATA 
(INS = '09') 

- EVT FIELD OFF 

- EVT_FIELD_ON 


Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


uicc.hci. framework. HCI Exceptio 

n with error code 

HCI LISTENER ALREADY RE 

GISTERED 


(SW-'6F01') 






EVT CARD ACTIV 












ATED 












- Select the applet 
-Send 












EVT SEND DATA 












(INS = '09') 











6.1 .2.2 Method deregister 

Test Area Reference: Api_l_Hsr_Drg. 

6.1.2.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void deregister {HCIListener listener) 

6.1.2.2.1.1 Normal execution 

• CRRNl: deregisters a Listener object from the Service instance. 

• CRRN2: Calling deregister with an argument that does not identify a currently registered HCIListener has no 
effect. 

• CRRN3: Applets communicating through the process() method shall also be able to use the API services 
defined in TS 102 705 [1] which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.1.2.2.1.2 

• None. 

6.1.2.2.1.3 

• None. 

6.1.2.2.2 



Parameter errors 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Drg l.java 


1 


Api 1 Hsr Drg 2.java 


2 
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6.1.2.2.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.2.2.4 



Test procedure 



Test case 


ID 


HCI Command | API Description | API Expectation | HCI Response |CRR 


1 


Deregister Listener to a Service - CardEmulation 


1 - EVT SEND DATA 
(INS = '01') 


register { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 

deregister { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N1, 
N3 


2 - EVT SEND DATA 
(INS = '02') 


deregister { ) 

Service = 

Connect ivityService 

Listener = 

CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA(SW- 
'90 00') 


N2, 


3 - EVT SEND DATA 
(INS = '03') 


deregister { ) 
Service = 

CardEmulationService 
Listener = 
CardEmulationListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2, 
N3 


2 


Deregister Listener to a Service - Connectivity 


1 - EVT SEND DATA 
(INS = '01') 


register { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 

deregister { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N1 


2 - EVT SEND DATA 
(INS = '02') 


deregister { ) 

Service = 

CardEmulationService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2 


3 - EVT SEND DATA 
(INS = '03') 


deregister { ) 

Service = 

Connect ivityService 

Listener = 

Connect ivityListener 


No exception shall 
be thrown 


EVT SEND DATA (SW- 
'90 00') 


N2 



6.1.2.3 Method activateEvent 

Test Area Reference: Api_l_Hsr_Ace. 

6.1.2.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void activateEvent {byte event) 

throws HCIException 
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6.1 .2.3.1 .1 Normal execution 

• CRRNl: This method is used to activate an event. 

• CRRN2: for all service interfaces HCIListener.EVENT_HCI_TRANSMISSION_FAILED is sent to notify the 
applet when the UICC failed to transmit a message sent by CLF. 

• CRRN3: for all service interfaces HCIListener.EVENT_HCI_RECEPTIONS_F AILED is sent to notify the 
applet when the UICC failed to receive a message sent by CLF. 

• CRRN4: Possible values for event for Card emulation service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_ON_SEND_DATA. 

EVENT_FIELD_OFF. 

• CRRN5: Possible values for event for Reader service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_WRITE_EXCHANGE_DATA_RESPONSE. 

EVENT_TARGET_DISCOVERED. 

• CRRN6: Possible value for event for Connectivity service is EVENT_STAND_BY. 

• CRRN7: The Registration of Listener Interfaces and activation of events shall be persistent. 

• CRRN8: When the contactless interface is disabled (cf. "state of contactless functionality" in TS 102 223 [7] 
and setCommunicationlnterfaceO API method of "GlobalPlatform Amendment C" [10]), the Contactless 
Framework shall throw an HCIException with reason code HCI_CURRENTLY_DISABLED. 

• CRRN9: The Contactless Framework shall raise an EVENT_FIELD_OFF if this event is activated for this 
Applet instance, before the invocation of the deselect() method of the Applet instance. 

• CRRNIO: After the EVENT_FIELD_OFF event the Applet instance shall not be triggered by any other event 
until the Applet instance is selected again. 

• CRRN 1 1 : If the current application protocol is APDU based the HCI framework shall handle an application 
session termination according to TS 102 221 [5] independent of the interface used for message exchange. 

• CRRN12: Applet selection and deselection shall be performed by the Contactless Framework according to the 
rules defined in the "Java Card^"^ Runtime Environment Specification, 3.0 Classic Edition" [11] and in 
"GlobalPlatform Amendment C" [10]. 

• CRRN 13: The select() method of the Applet instance shall always be invoked for an Applet selection 
according to the rules given in "Java Card'"^ Runtime Environment Specification, 3.0 Classic Edition" [11]. 

• CRRN 14: If the HCI event EVT_FIELD_OFF or EVT_CARD_DEACTIVATED defined by the HCI protocol 
as specified in [4] is received by the Contactless Framework and the UICC is still powered, the Applet 
instance shall be deselected according to "GlobalPlatform Amendment C" [10]. 

6.1.2.3.1.2 Parameter errors 

• CRRPl: HCIException with reason code HCI_WRONG_EVENT_TYPE if a wrong event was activated for 
this service instance. 

• CRRP2: HCIException with reason code HCI_CURRENTLY_DIS ABLED if the interface to the contactless 
frontend (CLF) is currently disabled and the event is ReaderListener.EVENT_TARGET_DISCOVERED. 

6.1.2.3.1.3 Context errors 

• None. 
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Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Ace l.java 


1 


Api 1 Hsr Ace S.java 


2 


Api 1 Hsr Ace 2.java 


3 


Api 1 Hsr Ace l.java 


4 


Api 1 Hsr Ace 7.java 


5 


Api 1 Hsr Ace 4.java 


6 


Api 1 Hsr Ace S.java 


7 


Api 1 Hsr Ace 6.java 


8 


Api 1 Hsr Ace S.java 


9 


Api 1 Hsr Ace 6.java 


10 



6.1.2.3.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



6.1.2.3.4 



Test procedure 



Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response 


CRR 


1 


Event activation - CardEmulationService 


1 - EVT SEND DATA(INS = 
'10') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N2 






CardEmulationService 












activateEvent ( ) 












event = 












HCIListener. EVENT HCI TRANSMI 












SSION FAILED 








2 - EVT SEND DATA(INS = 
'11') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N3 






CardEmulationService 












activateEvent ( ) 












event = 












HCIListener. EVENT HCI RECEPTI 












ONS FAILED 








3 - EVT SEND DATA(INS = 
'12') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N4 






CardEmulationService 












activateEvent ( ) 












event = 












CardEmulationListener .EVENT G 












ET PARAMETER RESPONSE 








4- 

- EVT SEND DATA(INS = 

'14') 


HCIListener = 
CardEmulationListener 
HCIService = 


No exception shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N4 




CardEmulationService 












activateEvent ( ) 












event = 












CardEmulationListener .EVENT 












N SEND DATA 
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Test Case 


ID 


HCI Command Description API Expectation HCI Response CRR 


2 


Event activation - ReaderService 


1 - EVT SEND DATA (INS = 
'11') 


HCIService = ReaderService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_RECEPTI 

ONS FAILED 


No exception shall 
be thrown. 


SW - '90 00' 


N1, 
N3 


2- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='11' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT_TARGET_DISCOVERED 


No exception shall 
be thrown. 


SW - '90 00' 


N1, 
N5 


3 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='12' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT WRITE EXCHANGE DATA RES 

PONSE 


No exception shall 
be thrown. 


SW - '90 00' 


N1, 
N5 


4 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='13' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


No exception shall 
be thrown. 


SW - '90 00' 


N1, 
N2. 


5 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
-SendAPDU INS='14' 


HCIService = ReaderService 

activateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 


No exception shall 
be thrown. 


SW - '90 00' 


N1, 
N5 


3 


Event activation - ConnectivityListener 


1 - EVT SEND DATA(INS = 
'10') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_TRANSMI 

SSION FAILED 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N2 


2 - EVT SEND DATA(INS = 
'11') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = 

HCIListener . EVENT_HCI_RECEPTI 

ONS FAILED 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, 
N3 


3 - EVT SEND DATA(INS = 
'12') 


HCIListener = 
ConnectivityListener 
HCIService = 
Connect ivityService 

activateEvent ( ) 

event = EVENT STAND BY 


No exception shall 
be thrown. 


EVT SEND DATA 
(SW- '90 00') 


N1, N6 


4 


Wrong event type 


EVT SEND DATA (INS = 
'16') 


HCIListener = 
CardEmulationListener 
HCIService = 
CardEmulationService 

activateEvent ( ) 
event value = 0x02 


HCIException with 
reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


EVT SEND DATA 
(SW- '90 00') 


PI 
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Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response 


GRR 


5 


HCI is disabled 


1- Precondition: Contactless 


HCIService = ReaderService 


HCIException with 


SW- '90 00' 


P2, N8 




functionality state is disabled 


activateEvent ( ) 


reason code 








in the UICC as defined in 


event = 


HCI CURRENTLY 








TS 102 223 [7]. Send on ISO 


ReaderListener .EVENT TARGET D 
ISCOVERED 


_DISABLED shall 








interface tlie following 




be thrown 








commands 












- Send APDU to select the 












applet. 












- Send APDU 












(INS = '01') on ISO interface 












2 - Precondition: Contactless 


setCommunicationlnterf ace ( ) 


HCIException with 


SW- '90 00' 


P2, N8 




functionality state is disabled 


API method of "GlobalPlatf orm 


reason code 








in the UICC as defined in 


Amendment C" [10] used to 


HCI CURRENTLY 








Global Platform Amendment 


disable HCI interface 
HCIService = ReaderService 


_DISABLED shall 








C. Send on ISO interface 


activateEvent ( ) 


be thrown 








send the following 


event = 










commands: 


ReaderListener . EVENT_TARGET_D 










- Send APDU to select the 


ISCOVERED 










applet. 

-Send APDU (INS = '01') on 


setCommunicationlnterf ace ( ) 
API method of Global 










ISO interface 


Platform Amendment C [10] is 










- Postcondition: 


used to enable again HCI 










Contactless functionality 


interface 










state is enabled again in the 












UICC as defined in Global 












Platform Amendment C 










6 


Persistent Event Activation 


-Send 


Service = 




- 


N7 




EVT SEND DATA (INS = 


CardEmulationService 


No exception shall 


EVT SEND DATA 






'01') 


Listener = 
CardEmulat ionListener 


be thrown. 


(SW- '90 00') 






- EVT_FIELD_OFF 




getEventNotificatio 


- 






- Power off 


activateEvent (EVENT FIELD OFF 


nStatusO = true 


EVT SEND DATA 






- Power on 


) 




(SW- '90 00') 






- EVT FIELD ON 












- EVT_CARD_ACTIVATED 












- Select the applet 












- Send EVT SEND DATA 












(INS = '02') 










7 


Event Field Off before deselect 


- EVT FIELD OFF 


Service = 


EVENT_FIELD_OF 


EVT SEND DATA 


N9, 




- EVT FIELD ON 


CardEmulationService 


F raised before 


(SW- '90 00') 


Nil, 




- EVT_CARD_ACTIVATED 


Listener = 


deselectO 




N12, 




- Select the applet 


CardEmulat ionListener 
activateEvent (EVENT ON SEND D 






N14 




- Send EVT SEND DATA 


ATA) during the installation 










(INS = '01') 


onCallbackO 

activateEvent ( ) 

event = EVENT_FIELD_OFF 

deselect ( ) 








8 


No triggering after Event Field Off 


EVT FIELD OFF 


Service = 


EVENT ON SEN 


No response, or 


N1, 




- Send EVT SEND DATA 


CardEmulationService 


D_DATA shall not 


EVT_SEND_DATA 


N4, 




(INS = '01') 


Listener = 
CardEmulat ionListener 


be raised 


with any response 
except: 


N10, 
N11 






activateEvent (EVENT_ON_SEND_D 








ATA) during the installation 




(SW - '90 00') 








onCallbackO 












activateEvent 












event = EVENT FIELD OFF 








9 


Check for Selection 


Send EVT SEND DATA 


Service = 


Check for 


EVT SEND DATA 


N12, 




(INS = '01') 


CardEmulationService 
Listener = 


invocation of 
selectO 


(SW - '90 00') 


N13 






CardEmulat ionListener 
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Test Case 


ID 


HCI Command 


Description API Expectation 


HCI Response CRR 


10 


No triggering after Event Card Deactivate 


EVT CARD DEACTIVATE 
- Send EVT SEND DATA 
(INS = '01') 


Service = 

CardEmulationService 
Listener = 

CardEmulationListener 
activateEvent (EVENT ON SEND D 
ATA) during the installation 
onCallback () 

activateEvent ( ) 

event = EVENT FIELD OFF 


EVT_SEND_DATA 
shall not be raised 


No response or 

EVT_SEND_DATA 

withany response 

except: 

(SW - '90 00' or '6D 

00') 


N12, 
N14 



6.1 .2.4 Method deactivateEvent 

Test Area Reference: Api_l_Hsr_Dae. 

6.1.2.4.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void deactivateEvent {byte event) 

throws HCIException 

6.1.2.4.1.1 Normal execution 

• CRRNl: deactivates an event from the list of activated events. 

• CRRN2: for all service interfaces HCIListenr.EVENT_HCI_TRANSMISSION_F AILED is sent to notify the 
applet when the UICC failed to transmit a message sent by CLE. 

• CRRN3: for all service interfaces HCIListenr HCIListener.EVENT_HCI_RECEPTIONS_F AILED is sent to 
notify the applet when the UICC failed to receive a message sent by CLE. 

• CRRN4: Possible values for parameter event for Card emulation service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_ON_SEND_DATA. 

EVENT_EIELD_OEE. 

• CRRN5: Possible values for parameter event for Reader service are: 

EVENT_GET_PARAMETER_RESPONSE. 

EVENT_WRlTE_EXCHANGE_DATA_RESPONSE. 

EVENT_TARGET_DISCOVERED. 

• CRRN6: Possible values for Connectivity service is EVENT_STANDBY. 



6.1.2.4.1.2 



Parameter errors 



CRRPl: HCIException with reason code HCIException.HCI_WRONG_EVENT_TYPE in case a wrong event 
was deactivated for this service instance. 

CRRP2: HCIException with reason code.HCI_WRONG_EVENT_TYPE in case the event wasn't activated 
before. 



6.1.2.4.1.3 
• None. 



Context errors 
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Test suite files 



Applet Name 


Test case ID 


Api 1 Hsr Dae l.java 


1-1 


Api 1 Hsr Dae l.java 


1-2 


Api 1 Hsr Dae 2.java 


1-3 


Api 1 Hsr Dae 2.java 


1-4 


Api 1 Hsr Dae S.java 


2 


Api 1 Hsr Dae 4.java 


3 


Api 1 Hsr Dae l.java 


4 


Api 1 Hsr Dae S.java 


5 


Api 1 Hsr Dae 6.java 


6 


Api 1 Hsr Dae 7.java 


7 



6.1.2.4.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.2.4.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response CRR 


1 


Event deactivation - CardEmulationService 


1 - 


HCIService = 


No exception shall 


EVT SEND DAT 


N1,N2 




EVT_SEND_DATA(INS='1 0') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 


be thrown 


A (SW- '90 00') 




2- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1, N3 




EVT_SEND_DATA(INS='1 1 ') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_REC 

EPTIONS FAILED 


be thrown 


A (SW- '90 00') 




3- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1, N4 




EVT_SEND_DATA(INS='1 2') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT GET PARAMETER RESPONSE 


be thrown 


A (SW- '90 00') 




4- 


HCIService = 


No exception shall 


EVT SEND DAT 


N1,N4 




EVT_SEND_DATA(INS='1 4') 


CardEmulationService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT ON SEND DATA 


be thrown 


A (SW- '90 00') 
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Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Event deactivation - ReaderService 



1- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.3.3 not applicable here 
- Send APDU (INS='09') 



HCIService = 
ReaderService 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 



No exception shall 
be thrown 



SW - '90 00' 



N1, N2 



2 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='10') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = HCIListener. 
EVENT_HCI_TRANSMISSION_FA 
ILED 



No exception shall 
be thrown 



SW - '90 00' 



N1,N3 



3 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='11') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 
Event has been 
successfully activated 

deactivateEvent { ) 
event = 

EVENT_GET_PARAMETER_RES PO 
NSE 



No exception shall 
be thrown 



SW - '90 00' 



N1, N5 



4 - Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='12') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderService 

deactivateEvent { ) 
event = 

EVENT_WRITE_EXCHANGE_DATA 
RESPONSE 



No exception shall 
be thrown 



SW - '90 00' 



N1,N5 



5- Send command on ISO 
interface to select applet; the 
initial conditions in clause 
6.1 .2.4.3 not applicable here 
-Send APDU (INS='13') 



HCIListener = 
ReaderListener 
HCIService = 
ReaderServiceEvent has 
been successfully 
activated 

deactivateEvent { ) 

event = 

EVENT TARGET DISCOVERED 



No exception shall 
be thrown 



SW - '90 00' 



N1, N5 



Event deactivation - ConnectivityService 



1 - 
EVT_SEND_DATA(INS='1 0') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 



No exception shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



N1,N2 



EVT_SEND_DATA(INS='1 1 ') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_REC 

EPTIONS FAILED 



No exception shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N3 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




3- 


HCIListener = 


No exception shall 


EVT SEND DAT 


N1, 




EVT_SEND_DATA(INS='1 2') 


Connect ivityListener 
HCIService = 
ConnectivityService 
Event has been 
successfully activated 

deactivateEvent { ) 

event = EVENT STAND BY 


be thrown 


A (SW- '90 00') 


N6 


4 


Wrong event type 


EVT SEND DATA (INS = '16') 


HCIService = 


HCIException with 


EVT SEND DAT 


PI 






CardEmulationService 


reason code 


A (SW- '90 00') 








Event has been 


HCI WRONG EV 










successfully activated 


ENT TYPE shall 










deactivateEvent { ) 


be thrown 










event value = 02 








5 


Deactivate an non-active event - CardEmulatlonServlce 


1 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'10') 


CardEmulationService 

Event was not activated 

before 

deactivateEvent { ) 

event = 

HCIListener . EVENT_HCI_TRA 

NSMISSION FAILED 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




2 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'11') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

HCIListener . EVENT_HCI_REC 
EPTIONS FAILED 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




3 - EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'12') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT GET PARAMETER RESPONSE 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




4 -EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'13') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT FIELD OFF 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




5- EVT SEND DATA (INS = 


HCIService = 


HCIException with 


EVT SEND DAT 


P2 




'14') 


CardEmulationService 
Event was not activated 
before 

deactivateEvent { ) 
event = 

CardEmulationListener . EVE 
NT ON SEND DATA 


reason code 
HCI WRONG EV 
ENT_TYPE shall 
be thrown 


A (SW- '90 00') 




6 


Deactivate an non-active event - ConnectivityService 


EVT SEND DATA(INS='12') 


HCIListener = 


HCIException with 


EVT SEND DAT 


P2 






Connect ivityListener 


reason code 


A (SW- '90 00') 








HCIService = 


HCI WRONG EV 










ConnectivityService 
Event was not activated 


ENT_TYPE shall 










before 


be thrown 










deactivateEvent {) 












event = EVENT STAND BY 
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Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Deactivate an non-active event - ReaderService 



1 - 
EVT_SEND_DATA(INS='1 0') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 
event = 

EVENT_GET_PARAMETER_RES PO 
NSE 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



EVT_SEND_DATA(INS='1 1 ') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 
event = 

EVENT_WRITE_EXCHANGE_DATA 
RESPONSE 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



EVT_SEND_DATA(INS='1 2') 



HCIListener = 

ReaderListener 

HCIService = 

ReaderService 

Event was not activated 

before 

deactivateEvent { ) 

event = 

EVENT TARGET DISCOVERED 



HCIException with 
reason code 
HCI_WRONG_EV 
ENT_TYPE shall 
be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P2 



6.1.2.5 Method requestCallbackNotification 

Test Area Reference: Api_l_Hsr_Rcn. 

6.1.2.5.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void requestCallbackNotification {byte event) 

throws HCIException 

6.1.2.5.1.1 Normal execution 

• CRRNl : the call of this method trows HCIException with reason code HCI_ACCESS_NOT_GRANTED. 

6.1.2.5.1.2 Parameter errors 

• None. 



6.1.2.5.1.3 
• None. 

6.1.2.5.2 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Ren 7.java 


1 
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6.1.2.5.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .2.5.4 Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Request Callback Notification 



EVT_SEND_DAT 
A (INS = '10') 



Precondition : 

HCIService = 

CardEmulationService 

Corresponding listener 

registered 

No event is activated 

requestCallbackNotif ication {) 
event = 

HCIListener . EVENT_HCI_TRANSMISS 
ION FAILED 



throws HCIexception 
with reason code 
HCI_ACCESS_NOT_ 
GRANTED 



EVT_SEND_DAT 
A (SW- '90 00') 



N1 



6.1.2.6 Method getEventNotificationStatus 

Test Area Reference: Api_l_Hsr_Gen. 

6.1.2.6.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean getEventNotificationStatus {byte event) 

throws HCIException 

6.1 .2.6.1 .1 Normal execution 

• CRRNl: return the activation state of an event; if true the event is activated for this listener, else false. 

• CRRN2: For CardEmulationService:EVENT_GET_PARAMETER_RESPONSE, EVENT_SEND_DATA, 
and EVENT_FIELD_OFF. 

• CRRN3: For ReaderService: EVENT_GET_PARAMETER_RESPONSE, 
EVENT_WRITE_EXCHANGE_DATA_RESPONSE, and EVENT_TARGET_DISCOVERED. 

• CRRN4: For ConnectivityService: ConnectivityListener.EVENT_STANDBY. 

• CRRN5: For all service interfaces: HCIListener.EVENT_HCI_TRANSMISSION_F AILED 
HCIListener.EVENT_HCI_RECEPTIONS_FAILED. 



6.1.2.6.1.2 



Parameter errors 



CRRPl: HCIException with reason code HCIException.HCI_WRONG_EVENT_TYPE in case the event was 
not one of the possible values. 



6.1.2.6.1.3 
• None. 



Context errors 
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Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hsr Gen l.java 


1 


Api 1 Hsr Gen l.java 


2 


Api 1 Hsr Gen S.java 


3 


Api 1 Hsr Gen S.java 


4 


Api 1 Hsr Gen l.java 


5-1 


Api 1 Hsr Gen S.java 


5-2 


Api 1 Hsr Gen 2.java 


5-3 


Api 1 Hsr Gen 2.java 


6 


Api_1_Hsr_Gen_2.java 


7 



6.1.2.6.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 



6.1.2.6.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - CardEmulationService 



1 - 

EVT_SEND_DATA 
(INS = '10') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_TRANSM 
ISSION FAILED 



No exception sliall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N5 



EVT_SEND_DATA 
(INS = '11') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_RECEPT 
IONS FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N5 



EVT_SEND_DATA 
(INS = '12') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

CardEmulat ionListener . EVENT_ 
GET PARAMETER RESPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 



4- 

EVT_SEND_DATA 
(INS = 'IS') 



4 HCIService = 
CardEmulationService 

getEventNotif icationStatus () 
event = 

CardEmulationListener . 
EVENT FIELD OFF 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 



5- 

EVT_SEND_DATA 
(INS = '14') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus ( ) 
event = 

CardEmulationListener . 
EVENT ON SEND DATA 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW- '90 00') 



N1, N2 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


2 


Event notification status true - CardEmulationService 


EVT SEND DATA 


HCIService = 






N1, N2 




(INS = '15') 


CardEmulationService 

activateEvent ( ) 

event = 

CardEmulat ionListener . EVENT 

ON_SEND_DATA 

getEventNotif icationStatus 

event = 


No exception shall be thrown. 

getEventNotificationStatusO = 
true 


EVT SEND DAT 
A (SW- '90 00') 


















CardEmulat ionListener . EVENT_ 












ON SEND DATA 








3 


Event notification status true - ReaderService 


1 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




on ISO interface to 


activateEvent ( ) 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT WRITE EXCHANGE DATA RE 

SPONSE 


getEventNotificationStatusO = 
true 








not applicable here 












- Send APDU (INS 


getEventNotif icationStatus ( ) 










= '21') 


event = 

ReaderListener . 

EVENT_WRITE_EXCHANGE_DATA_RE 
SPONSE 








2 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




on ISO interface to 












select applet; the 
initial conditions in 
clause 6.1.2.6.5 


activateEvent ( ) 

event = 

ReaderListener . EVENT_TARGET_ 

DISCOVERED 


getEventNotificationStatusO = 
true 








not applicable here 












Send APDU (INS 


getEventNotif icationStatus () 










= '22') 


event = 

ReaderListener .EVENT TARGET 

DISCOVERED 








3 - Send APDU 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N3 




(INS = '23') 


activateEvent ( ) 
event = 
ReaderListener . 


getEventNotificationStatusO = 
true 










EVENT_GET_PARAMETER_RESPONSE 










getEventNotif icationStatus () 












event = 












ReaderListener . 












EVENT GET PARAMETER RESPONSE 








4 - Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N5 




on ISO interface to 


activateEvent () 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT_HCI_RECEPTIONS_FAILED 


getEventNotificationStatusO = 
true 








not applicable here 


getEventNotif icationStatus () 










-Send APDU (INS 


event = 










= '24') 


ReaderListener . 

EVENT HCI RECEPTIONS FAILED 








5- Send command 


HCIService = ReaderService 


No exception shall be thrown. 


SW - '90 00' 


N1,N5 




on ISO interface to 


activateEvent ( ) 










select applet; the 
initial conditions in 
clause 6.1.2.6.5 


event = 

ReaderListener . 

EVENT HCI TRANSMISSION FAILE 

D 


getEventNotificationStatusO = 
true 








not applicable here 












-Send APDU (INS 


getEventNotif icationStatus () 










= '25') 


event = 

ReaderListener . 

EVENT_HCI_TRANSMISSION_FAILE 
D 









£75/ 



(Release 9) 



42 



ETSI TS 103 115 V9.0.0 (2013-04) 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - ReaderService 



1 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='10') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 
event = HCIListener. 
EVENT_HCI_TRANSMISSION_FAILE 
D 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N5 



2 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
-Send APDU (INS 

^^m 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



3 - Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='12') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 
event = 

EVENT_WRITE_EXCHANGE_DATA_RE 
SPONSE 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



4- Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
-Send APDU (INS 
= ■13') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT TARGET DISCOVERED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



5- Send command 
on ISO interface to 
select applet; the 
initial conditions in 
clause 6.1.2.6.5 
not applicable here 
- Send APDU 
(INS='14') 



HCIListener = ReaderListener 
HCIService = 

ReaderServiceEvent has been 
successfully activated 

deactivateEvent ( ) 

event = 

EVENT HCI RECEPTION FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



SW - '90 00' 



N1, 
N3 



Wrong event type 



1- 

EVT_SEND_DATA 
(INS = '16') 



HCIService = 
CardEmulationService 

getEventNotif icationStatus ( ) 
event = 0x02 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



EVT_SEND_DAT 
A (SW- '90 00') 



P1 



2- Send on ISO 
interface 

-Send APDU (INS 
= '16') 



HCIService = ReaderService 

getEventNotif icationStatus () 
event = 0x84 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



SW - '90 00' 



P1 



3- 

EVT_SEND_DATA 
(INS = '16') 



HCIService = 
Connect ivityService 

getEventNotif icationStatus () 
event = 0x02 



HCIException with reason 
code 

HCI_WRONG_EVENT_TYPE 
shall be thrown 



EVT_SEND_DAT 
A (SW - '90 00') 



P1 
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Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



Event notification status false - ConnectlvltyServlce 



1 - 

EVT_SEND_DATA 
(INS = '10') 



HCIListener = 
Connect ivityListener 
HCIService = 
Connect ivityService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_TRANSM 
ISSION FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N5 



2- 

EVT_SEND_DATA 
(INS = '11') 



HCIListener = 
Connect ivityListener 
HCIService = 
Connect ivityService 

getEventNotif icationStatus () 
event = 

HCIListener . EVENT_HCI_RECEPT 
IONS FAILED 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N5 



EVT_SEND_DATA 
(INS = '12') 



HCIListener = 
Connect ivityListener 
HCIService = 
Connect ivityService 

getEventNotif icationStatus () 
event = 

Connect ivityListener . EVENT_S 
TAND BY 



No exception shall be thrown. 

getEventNotificationStatusO = 
false 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N4 



Event notification status true - ConnectivityService 



EVT_SEND_DATA 
(INS = '15') 



HCIListener = 
Connect ivityListener 
HCIService = 
ConnectivityService 

activateEvent ( ) 

event = 

Connect ivityListener . EVENT_S 

TAND_BY 

getEventNotif icationStatus () 
event = 

Connect ivityListener . EVENT_S 
TAND BY 



No exception shall be thrown. 

getEventNotificationStatusO = 
true 



EVT_SEND_DAT 
A (SW - '90 GO') 



N1, N4 



6.1.3 Interface HCI Message 

6.1.3.1 Method isHeading 

Test Area Reference: Api_l_Hme_Mhd. 

6.1 .3.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean isHeading {) 



6.1.3.1.1.1 



Normal execution 



CRRNl: Checks if the current content is the heading part of an HCP message The heading information 
indicates the first part of an HCP message; with the isComplete() method it is possible to check whether the 
complete message has already been received. 

CRRN2: returns true if the current message is the heading part of the message. 

CRRN3: An HCIMessage object shall encapsulate one HCP message according to the HCI protocol as 
specified in [3]. 
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• CRRN4: HCI message for the different contactless modes shall be identified by different types of interfaces. 

• CRRN5: In case the Applet instance has registered the CardEmulationListener and has activated the 
EVENT_ON_SEND_DATA the process() method of this Applet instance shall not be invoked during the 
selection. 

6.1.3.1.1.2 Parameter errors 

• None. 

6.1.3.1.1.3 Context errors 

• None. 



6.1.3.1.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hme Mhd l.java 


1 



6.1.3.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.3.1.4 Test procedure 

Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



message is complete 



EVT_SEND_DATA 
(INS ='01') 



onCallbackO 

event = 

E VENT_ON_S END_DATA 

HCIMessage . isHeading { ) 



No exception shall 
be thrown. 

isHeading = 
true 



EVT_SEND_DATA (SW - '90 00') 

Result returned in the first response 
byte of the R-APDU data: b1 is set 



N1, 
N2, 
N3, 
N4, 
N5 



6.1.3.2 MethodisComplete 

Test Area Reference: Api_l_Hme_Mco. 

6.1.3.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

boolean isCompleteO 



6.1.3.2.1.1 



Normal execution 



• CRRNl: this method checks for the completeness of the HCP message, i.e. the last received HCP packet had 
the chaining bit CB set to 1. It returns true if the message is complete. 

• CRRN2: the framework shall copy data into the receive buffer up to the end of the buffer. When the HCI 
message is longer than the available buffer length the HCIMessage shall be set as not complete. 



6.1.3.2.1.2 
• None. 



Parameter errors 
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6.1.3.2.1.3 
• None. 

6.1.3.2.2 



Context errors 



Test suite files 



Applet Name 


Test case ID 


Api 1 Hme Mco l.java 


1 



6.1.3.2.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.3.2.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



message is complete 



EVT_SEND_DATA 
(INS = '01') 



onCallbackO 

event = 

E VENT_ON_S END_D ATA 

HCIMessage . isComplete { ) 



No exception shall 
be thrown. 

isComplete ( ) = 
true 



EVT_SEND_DATA (SW 
- '90 00') 

Result returned in the 
second response byte of 
the R-APDU data: b1 is 
set 



N1 



6.1.3.3 Method getType 

Test Area Reference: Api_l_Hme_Mty. 

6.1.3.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 



byte getType { ) 



6.1.3.3.1.1 



Normal execution 



CRRNl: Returns the type of the incoming HCI message, it shall be one of constant values TYPE_defined in 
this interface. The returned type possibilities are: TYPE_COMMAND Indicates the HCI message type 
"command", TYPE_EVENT Indicates the HCI message type "event" and TYPE_RESPONSE indicates the 
HCI message type "response". 

CRRN2: In the case of a fragmented incoming message this method shall return the HCI message type coded 
in the first part of the HCI message. 



6.1.3.3.1.2 

• None. 

6.1.3.3.1.3 

• None. 



Parameter errors 



Context errors 
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Applet Name 


Test case ID 


Api 1 Hme Mty l.java 


1 


Api 1 Hme Mty 2.java 


2 



6.1.3.3.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .3.3.4 Test procedure 

Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response | CRR 



message of type event - Card emulation 



EVT_SEND_DATA 
(INS = '01') 



onCallbackO 

event = EVENT_ON_SEND_DATA 

HCIMessage.getType () 



No exception shall be 
thrown. 

getlype () = 
TYPE EVENT 



EVT_SEND_DATA 
(SW - '90 00') 

third response byte 
of the R-APDU data 
is '40' 



N1 



message of type event - Connectivity 



- Send command on 
ISO interface to select 
applet; the initial 
conditions in clause 
6.1.3.3.3 not 
applicable here 

- EVT_STANDBY 

- Send on ISO 
interface (INS = '01') 



extends ConnectivityListener 

activateEvent ( ) 

event = EVENT_STAND_BY 

onCallback ( ) 

event = EVENT_STAND_BY 

HCIMessage .getType () 



No exception shall be 
thrown. 

getType () = 
TYPE EVENT 



SW = '90 00' 

third response byte 
of the R-APDU data 
is '40' 



N1 



6.1.3.4 Method getlnstruction 

Test Area Reference: Api_l_Hme_Min. 

6.1.3.4.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte getlnstruction { ) 



6.1.3.4.1.1 



Normal execution 



• CRRNl: returns the instruction part of the HCP message header of the current incoming HCP message, see 
TS 102 622 [3] for further information. It returns the message instruction, b8,b7 of the return value are set to 
zero. 

6.1.3.4.1.2 Parameter errors 

• None. 

6.1.3.4.1.3 Context errors 

• None. 
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Test Suite Files 



Applet Name 


Test case ID 


Api 1 Hme Min l.java 


1 


Api 1 Hme Min 2.java 


2 



6.1.3.4.3 initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1 .3.4.4 Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


message of type event: Card emulation 


EVT SEND DATA 


onCallbackO 


No exception shall be 


EVT SEND DATA 


N1 




(INS = '01') 


event = EVENT_ON_SEND_DATA 
HCIMessage .getlnstruction ( ) 


tlirown. 
getlnstructionO = '10' 


(SW - '90 00') 
the 4th response 
byte of the R-APDU 
data is '10' 




2 


message of type response: Card emulation 


- EVT SEND DATA 


onCallback () 


No exception shall be 


- EVT SEND DATA 


N1 




(INS = '01') 


prepareAndSendGetParameterComman 


thrown. 


(SW - '90 00') 






- ANY OK(ATQA) 
- EVT_SEND_DATA 


d() 

parameter = 

PARAM ID TYPE A CARD ATQA 


getlnstructionO = '00' 


ANY GET PARAM 






(arbitrary data) 


onCallback 
event = 

EVENT_GET_PARAMETER_RESPONSE 
HCIMessage .getlnstruction () 




TER(ATQA) 

- EVT SEND DATA 

(SW - '90 00') 

the 4th response 
byte of the R-APDU 
data is '00' 





6.1.3.5 Method getReceiveOffset 

Test Area Reference: Api_l_Hme_Mro. 

6.1.3.5.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

short getReceiveOf f set { ) 



6.1.3.5.1.1 



Normal execution 



• CRRNl: this method returns the offset of the received HCI message data in the receive buffer, retrieved via 
getReceiveBuffer(). 



6.1.3.5.1.2 
• None. 



Parameter errors 



Context error 



6.1.3.5.1.3 
• None. 
NOTE: This method is implicitly tested in clause 6.1.3.7. 
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6.1 .3.6 Method getReceiveLength 

Test Area Reference: Api_l_Hme_Mrl. 

6.1.3.6.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

short getReceiveLength { ) 

6.1.3.6.1.1 Normal execution 

• CRRNl: this method returns the length of the received HCI message data. It is the size of the message data 
available in the receive buffer. 

6.1.3.6.1.2 Parameter errors 

• None. 

6.1.3.6.1.3 Context error 

• None. 



6.1.3.6.2 



Test Suite Files 



Applet Name 


Test case ID 


Api_1_Hme_Mrl_1 .Java 


1 



6.1.3.6.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.1 .3.6.4 Test procedure 

Test case 



API Description 



HCI Response |CRR 



ID 



HCI Command 



'I Description | API Expectation | 

received message length: CardEmulationService 

c{) Nn fixnfintinn .qhall FVT 



Get 



EVT_SEND_DATA: 
Send message with 
the length 'OA' 
message is complete 



onCallback { ) 

event = EVENT_ON_SEND_DATA 

HCIMessage . getReceiveLength { ) 



No exception shall 
be thrown. 

getReceiveLengthQ 
= '0A' 



EVT_SEND_DATA (SW - 
'90 00') 

Result returned in the 7th 
and 8th response byte of 
the R-APDU data ('00 OA') 



N1 



6.1 .3.7 Method getReceiveBuffer 

Test Area Reference: Api_l_Hme_Mrb. 

6.1.3.7.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte [] getReceiveBuf f er { ) 
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6.1.3.7.1.1 



Normal execution 



CRRNl: returns a reference to the underlying HCI message receive buffer. The length of this buffer is system 
dependent; it is guaranteed to be at least 270 bytes. 

CRRN2: it returns the buffer holding the current HCI message. 

CRRN3: the content of the array starts at the location indicated by getReceiveOffset() and has the length 
indicated by getReceiveLength(). 



6.1.3.7.1.2 


Parameter errc 


• None. 




6.1.3.7.1.3 


Context errors 


• None. 




6.1.3.7.2 


Test suite files 



Applet Name 


Test case ID 


Api 1 Hme Mrb l.java 


1 



6.1.3.7.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.1.3.7.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



Message length < 270 bytes 



EVT_SEND_DATA (message 
with the length = 09: '00 01 02 
03 04 05 06 07 08') 



onCallbackO 
event = 

E VENT_ON_S END_D ATA 
getReceiveBuf f er { ) 
getReceiveOf f set { ) 
getReceiveLength { ) 



No exception shall be 

thrown. 

First 9 bytes of 

getReceiveBufferO shall be 

'01 02 03 04 05 06 07 08 

09' 



EVT_SEND_DATA () 

First 9 bytes of the 
response data shall be '00 
01 02 03 04 05 06 07 08' 



N1, 
N2, 
N3 



6.1.4 Class HCI Exception 



6.1.4.1 Method throwit 

Test Area Reference: Api_l_Hxp_Trw. 

6.1 .4.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

public static void throwit {short reason) 
throws HCIException 

6.1 .4.1 .1 .1 Normal execution 

• CRRNl: Throws the JCRE owned instance of the HCIException with the specified reason code. 
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6.1.4.1.1.2 Parameter errors 

• None. 

6.1.4.1.1.3 Context errors 

• None. 



6.1.4.1.2 



Test suite files 



Applet Name 


Test case ID 


Api_1_Hxp_Trw_1 .Java 


1 



6.1.4.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI Interface. 

6.1.4.1.4 Test procedure 

Test Case 



ID 



HCI Command 



API Description 



API Expectation | HCI Response | CRR 



Throw Exception 



1 - EVT_SEND_DATA 
(INS = '01') 



throwit 

rea£5on = HCI ACCESS NOT GRANTED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



2 - EVT_SEND_DATA 
(INS = '02') 



throwit 

rea£5on = HCI CONDITIONS NOT SATISFIED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



3 - EVT_SEND_DATA 
(INS = '03') 



throwit 

reason = HCI CURRENTLY DISABLED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



4-EVT_SEND_DATA 
(INS = '04') 



throwit 

reason = HCI FRAGMENTED MESSAGE ONGOING 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



5 - EVT_SEND_DATA 
(INS = '05') 



throwit 

reason = HCI INVALID LENGTH 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



6 - EVT_SEND_DATA 
(INS = '06') 



throwit 

reason = 

HCI LISTENER ALREADY REGISTERED 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



7-EVT_SEND_DATA 
(INS = '07') 



throwit 

reason = HCI NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



8 - EVT_SEND_DATA 
(INS = '08') 



throwit 

reason = HCI RESOURCES NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 



9 - EVT_SEND_DATA 
(INS = '09') 



throwit 

reason = HCI SERVICE NOT AVAILABLE 



Throw exception 
with 

corresponding 
reason code 



EVT_SEND_DA 
TA (SW - '90 00') 



N1 
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Test Case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 




10-EVT SEND DATA 
(INS = 'OA') 


throwit 

rea£3on = HCI_WRONG_EVENT_TYPE 


Throw exception 
with 

corresponding 
reason code 


EVT SEND DA 
TA (SW - '90 00') 


N1 


11 -EVT SEND DATA 
(INS = 'OB') 


throwit 

reason = HCI_WRONG_LISTENER_TYPE 


Throw exception 
with 

corresponding 
reason code 


EVT SEND DA 
TA (SW - '90 00') 


N1 



6.1.5 Interface HCIListener 
6.1.5.1 Method onCallback 

Test Area Reference: Api_l_Hln_Ocb. 

6.1 .5.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.1.5.1.1.1 



Normal execution 



• CRRNl: The Contactless Framework shall invoke the method *typeListener . onCallback only with 
events which are defined in this particular listener or HCIListener and only with message objects of this 
listener type. 

• CRRN2: The Applet instance shall activate the events with CardEmulationService.activateEvent before it will 
receive any event notification. 

• CRRN3: The context as defined in the Java CardT"^ specification [11], [12] and [13] shall be set to the context 
of the Applet which implements the onCallback() method. The previous context (context of the caller) shall be 
the context of the Contactless Framework. 

• CRRN4: Upon return from the onCallback() method a pending transaction shall be aborted. 

• CRRN5: As stated in TS 102 622 [3], a reset of the underlying data link layer shall be transparent to the 
application layer if the data link layer recovers without any loss of data. 

• CRRN6: The Contactless Framework shall be able to receive one or more HCI messages while waiting for a 
response related to a command originated by the Applet (e.g. processing a request for parameters) especially 
for the EVT_FIELD_OFF case. 

6.1.5.1.1.2 Parameter errors 

• None. 



6.1.5.1.1.3 
• None. 



Context errors 
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Test Suite Files 



Applet Name 


Test case ID 


Api 1 HIn Ocb 4.java 


1 


Api 1 HIn Ocb S.java 


2 


Api 1 HIn Ocb e.java 


3 


Api 1 HIn Ocb 2.java 


4 


Api 1 HIn Ocb S.java 


5 



6.1.5.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 



6.1.5.1.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


1 


Get context 


1 - Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N3 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 










Send 


process ( ) : 


expected AID = 








EVT SEND DAT 


JCSystem.getAID ; 


current AID 








A (INS = '01') 
) 










2 - Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N3 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 
process ( ) : 


previous AID = null 








Send 












EVT SEND DAT 


JCSystem.getPreviousContextAID ( 










A (INS = '02') 


) ; 








2 


Abort transaction 


Send 


Service = CardEmulationService 


No exception shall be 


EVT SEND DATA (SW 


N4 




EVT SEND DAT 


Listener = 


thrown 


'90 00') 






A (Select applet) 


CardEmulationListener 










-Send 


onCallbackO : 


Test array shall not be 








EVT SEND DAT 


JCsystem.beginTransaction ( ) ; 


modifed 








A (INS = '01') 


Set up test array 










-Send 


//no 










ENVELOPE UN 


JCSystem. commitTransaction! ! 










RECOGNIZED 


processToolkit () : 

check array modification 








3 


Data link layer recovery 


-Send 


Service = CardEmulationService 


No exception shall be 


- EVT SEND DATA 


N5 




EVT SEND DAT 


Listener = 


thrown 


(SW - '90 00') in the 






A (Select applet) 
-Send 


CardEmulationListener 
activateEvent (EVENT_ON_SEND_DAT 
A) during the installation 




response to selecting 
applet 






EVT SEND DAT 


onCallbackO 




- EVT SEND DATA 






A (INS = '01') 






(0x00, 0x00, 0x00, 0x00, 






- reset the 


prepareAndSendSendDataEvent ( ) 




0x00, 0x0, 0x00, 0x00, 






underlying data 


data = {OxOO, 0x00, 0x00, 




0x00, ...., 0x90, 0x00) 






link layer while 


0x00, 0x00, 0x0, 0x00, 0x00, 










receiving the 


0x0 0, .... , 0x90, 0x0 0} 




No loss of data expected 






reponse 


length = 256B 
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Test case 


ID 


HCI Command 


API Description API Expectation HCI Response 


CRR 


4 


Receive messages while waiting for get parameter 


EVT_SEND_DAT 
A (Select applet) 

EVT FIELD OFF 
before ANY_OK 


Listener = 

CardEmulationListener 
activateEvent ( ) 
event = 
EVENT_GET_PARAMETER_RESPONSE 

prepareAndSendGetParameterComma 

ndO 

paramID = 

PARAM ID TYPE B CARD ATQBC 


No exception shall be 
thrown 

onCallbackO shall 
receive ANY OK as 
EVENT GET PARAM 
ETER_RESPONSE 


EVT_SEND_DATA () 

ANY GET PARAMETE 
R(ATOB) 

No error after 
EVT_FIELD_OFF 


N1, 
N2, N6 


5 


Receive messages while waiting for get parameter 


EVT_SEND_DAT 
A (Select applet) 

EVT FIELD OFF 
before ANY_OK 


Listener = 

CardEmulationListener 
activateEvent ( ) 
event = 
EVENT_GET_PARAMETER_RESPONSE 

prepareAndSendGetParameterComma 

ndO 

paramID = 

PARAM ID TYPE A CARD ATQAD 


No exception shall be 
thrown 

onCallbackO shall 
receive ANY OK as 
EVENT GET PARAM 
ETER_RESPONSE 


EVT_SEND_DATA () 

ANY GET PARAMETE 
R(ATOA) 

No error after 
EVT_FIELD_OFF 


N1, 
N2, N6 



6.2 Package uicc.hci.services 

6.2.1 Package Card Emulation Service 

6.2.1.1 Interface CardEmulationMessage 

6.2.1 .1 .1 Method prepareAndSendGetParameterCommand 

Test Area Reference: Api_2_CEm_ Sgp. 

6.2.1 .1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendGetParameterCommand {byte paramID) 

throws HCIException 



6.2.1.1.1.1.1 



Normal execution 



CRRNl: this non-blocking method builds the HCI command ANY_GET_PARAMETER for the indicated 
information and sends it to the appropriate Card RF Gate of the CLE. 

CRRN2: the paramID indicates a constant parameter of the requested value. 

CRRN3: The CardEmulationListener.onCallback method shall be called by the Contactless Framework. The 
HCI message that resulted in the selection of this Applet according to the rules defined in "GlobalPlatform 
Amendment C" [10] shall be provided by the CardEmulationMessage. 



6.2.1.1.1.1.2 



Parameter errors 



CRRPl: throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 



6.2.1.1.1.1.3 



Context errors 



• CRRC 1 : throws HCIException with the reason code HCI_FR AGMENTED_MES S AGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 
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CRRC2: throws HCIException with the reason code HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 



6.2.1.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Sgp l.java 


1-1 


Api 2 CEm Sgp 2.java 


1-2 


Api 2 CEm Sgp S.java 


1-S 


Api 2 CEm Sgp 4.java 


1-4 


Api 2 CEm Sgp S.java 


1-5 


Api 2 CEm Sgp 6.java 


1-6 


Api 2 CEm Sgp 7.java 


1-7 


Api 2 CEm Sgp S.java 


1-8 


Api 2 CEm Sgp 9.java 


2-1 


Api 2 CEm Sgp lO.java 


2-2 


Api 2 CEm Sgp 11. Java 


2-S 


Api 2 CEm Sgp 12.java 


2-4 


Api 2 CEm Sgp 1 S.java 


2-5 


Api 2 CEm Sgp 2.java 


S-1 


Api_2_CEm_Sgp_1 0.java 


S-2 



6.2.1.1.1.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 



6.2.1.1.1.4 



Test procedure 



Test case 



ID 



HCI Command 



API Description 



API Expectation 



HCI Response 



CRR 



Get parameter: Type A 



1 - 

EVT_SEND_DAT 
A (Sele 



prepareAndSendGetParameterCommand( 

) 

paramID = 

PARAM_ID_TYPE_A_CARD_APPLICATION_D 
ATAC 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



2- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD ATQAC 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD CID SUPPORT 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



4- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD CLT SUPPORT 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD DATARATE MAX 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



6- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD FWI SFGI 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = 

PARAM ID TYPE A CARD MODE 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 



8- 

EVT_SEND_DAT 
A (Select applet) 



prepareAndSendGetParameterCommand { 

) 

paramID = PARAM_ID_TYPE_A_CARD_SAK 



No exception shall be 
thrown 



GET_PARAMETER 
with the predefined 
parameter value 



N1, 
N2, NS 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


2 


Get parameter: Type B 


1- 




No exception shall be 


GET_PARAMETER 


N1, 




EVT_SEND_DAT 


prepareAndSendGetParameterCommand { 


thrown 


with the predefined 


N2, N3 




A (Select applet) 


) 

paramID = 

PARAM ID TYPE B CARD AFIPP 




parameter value 




2- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET_PARAMETER 


N1, 




EVT_SEND_DAT 


) 


thrown 


with the predefined 


N2, N3 




A (Select applet) 


paramID = 

PARAM ID TYPE B CARD ATQB 




parameter value 




3- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET_PARAMETER 


N1, 




EVT_SEND_DAT 


) 


thrown 


with the predefined 


N2, N3 




A (Select applet) 


paramID = 

PARAM ID TYPE B CARD DATARATE MAX 




parameter value 




4- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET_PARAMETER 


N1, 




EVT_SEND_DAT 


) 


thrown 


with the predefined 


N2, N3 




A (Select applet) 


paramID = 

PARAM_ID_TYPE_B_CARD_HIGHER_LAYER_ 

RESPONSE 




parameter value 




5- 


prepareAndSendGetParameterCommand { 


No exception shall be 


GET_PARAMETER 


N1, 




EVT_SEND_DAT 


) 


thrown 


with the predefined 


N2, N3 




A (Select applet) 


paramID = 

PARAM ID TYPE B CARD MODE 




parameter value 




3 


The Contactless Framework is receiving fragmented HCI IVIessage 


1 - Select applet 


prepareAndSendGetParameterCommand { 


Shall throw 


- SW - '90 00' on ISO 


C1 




on ISO interface 


) 


uicc.hci.framework.HCIE 


interface 








paramID = 


xception with error code 


- EVT SEND DATA 






Send as 


PARAM_I D_TYPE_A_CARD_ATQA 


HCI FRAGMENTED M 


(No data) 






fragmented HCI 




ESSAGE_ONGOING 


- EVT_SEND_DATA 






Message: 






(one byte with second 






- 






least significant bit set) 






EVT_SEND_DAT 












A (data length = 












supported buffer 












size + 5 bytes, 












message not 












complete) 












With CB = 1 for 












the last sent 












frame 












EVT_SEND_DAT 












A sent without 












waiting for 












response 










2 - Select applet 


prepareAndSendGetParameterCommand { 


Shall throw 


- SW - '90 00' on ISO 


C1 




on ISO interface 


) 


uicc.hci.framework.HCIE 


interface 






Send as 


paramID = 

P ARAM_I D_T Y P E_B_C ARD_ATQB 


xception with error code 
HCI FRAGMENTED M 


- EVT SEND DATA 
(No data) 






fragmented HCI 




ESSAGE_ONGOING 


- EVT_SEND_DATA 






Message: 






(one byte with second 






EVT_SEND_DAT 






least significant bit set) 






A (data length = 












supported buffer 












size + 5 bytes, 












message not 












complete) 












EVT_SEND_DAT 












A sent without 












waiting for 












response 
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6.2.1 .1 .2 Method prepareAndSendSendDataEvent 

Test Area Reference: Api_2_CEm_ Ssd. 

6.2.1 .1 .2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendSendDataEvent {byte [] data, 

short offset, 

short len) 

throws HCIException, 

Java. lang. Null Point erExcept ion, 

Java. lang. ArraylndexOutOfBoundsExcept ion 



6.2.1.1.2.1.1 



Normal execution 



• CRRNl : This non-blocking method builds the the HCI event EVT_SEND_DATA sends it to the Contactless 
Card Emulation Gate of the CLE. 

• CRRN2: the data to be sent should be formatted according to the HCI specification, the offset define the offset 
of data into the data buffer and the len define the length of data in the data buffer. 

• CRRN3: Applet instances shall receive CardEmulationMessages after the registration of a 
CardEmulationListener interface to a CardEmulationService only if the EVENT_ON_SEND_DATA is 
activated for the Applet instance. 

• CRRN4: The CardEmulationListener.onCallback method shall be called by the Contactless Eramework. The 
HCI message that resulted in the selection of this Applet according to the rules defined in "GlobalPlatform 
Amendment C" [10] shall be provided by the CardEmulationMessage. 

6.2.1.1.2.1.2 Parameter errors 

• CRRPl : throws java.lang.NullPointerException - if data is null. 

• CRRP2: throws java.lang. ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 



6.2.1.1.2.1.3 



Context errors 



CRRCl: throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throws HCIException with the reason code HCI_ERAGMENTED_MESSAGE_ONGOING if the 
Contactless Eramework is still receiving a fragmented HCI Message. 

CRRC3: throws HCIException with the reason code HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 



6.2.1.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Ssd Ljava 


1 


Api 2 CEm Ssd Ljava 


2 


Api 2 CEm Ssd Ljava 


3 


Api 2 CEm Ssd 4.java 


4 


Api 2 CEm Ssd 2.java 


5-1 


Api_2_GEm_Ssd_3.java 


5-2 
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6.2.1.1.2.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT CARD ACTIVATED has been sent on HCI interface. 



6.2.1.1.2.4 



Test procedure 



Test case 


ID 


HCI Commnad 


API Description API Expectation 


HCI Response 


CRR 


1 


Send data - Type A 


EVT SEND DATA 


prepareAndSendSendDataEvent ( 


No exception shall 


EVT SEND DATA 


N1, 




(Select applet) 


) 


be thrown 


({0x03, 0x04, 0x05, 


N2, 






data = {OxOl, 0x02, 0x03, 




0x06, 0x07}) 


N3, N4 






0x04, 0x05, 0x06, 0x07, 












0x08, 0x09} 












offset = 2 












length = 5 








2 


Send data - Type B 


EVT SEND DATA 


prepareAndSendSendDataEvent ( 


No exception shall 


EVT SEND DATA 


N1, 




(Select applet) 


) 


be thrown 


({0x03, 0x04, 0x05, 


N2, 






data = {OxOl, 0x02, 0x03, 




0x06, 0x07}) 


N3, N4 






0x04, 0x05, 0x06, 0x07, 












0x08, 0x09} 












offset = 2 












length = 5 








3 


Recption of fragmented HCI Message 


- EVT SEND DATA 


prepareAndSendSendDataEvent ( 


Shall throw 


- EVT SEND DATA 


C2 




to select applet 


) 


uicc.hci.frameworl<.H 


(SW - '90 00') 






Send as fragmented 
HCI Message: 


data = {OxOl, 0x02, 0x03, 
0x04, 0x05, 0x06, 0x07, 
0x08 0x09} 


CI Exception with 
error code 


- EVT SEND DATA 
(No data) 






- EVT SEND DATA 


offset - 2 


HCI FRAGMENTED 








(data length = 


length = 5 


MESSAGE ONGOI 


- EVT SEND DATA 






supported buffer size 




NG 


(SW- '90 02') 






+ 5 bytes, message 












not complete) 












- EVT SEND DATA 












(INS = '01') without 












waiting for response 












-Send 












EVT SEND DATA 












(INS = '01') 










4 


Send no data 


EVT SEND DATA 


prepareAndSendSendDataEvent ( 


Shall throw java.lang 


EVT SEND DATA 


PI 




(Select applet) 


) 


exception with error 


({OxFF, OxFF, OxFF, 








data = null 
offset = 2 
length = 5 


code 
NullPointerException 


OxFF, OxFF }) 




5 


Array Index Out Of Bounds 


1 - 


prepareAndSendSendDataEvent ( 


Shall throw java.lang 


EVT SEND DATA 


P2 




EVT SEND DATA 


) 


exception with error 


({OxFF, OxFF, OxFF, 






(Select applet) 


1 - data = {OxOl, 0x02, 
0x03, 0x04, 0x05, 0x06, 
0x07, 0x08, 0x09} 
offset = 2 
length = 15 


code 

ArraylndexOutOfBou 

ndsException 


OxFF, OxFF }) 




2- 


prepareAndSendSendDataEvent ( 


Shall throw java.lang 


EVT SEND DATA 


P2 




EVT SEND DATA 


) 


exception with error 


({OxFF, OxFF, OxFF, 






(Select applet) 


data = {OxOl, 0x02, 0x03, 
0x04, 0x05, 0x06, 0x07, 
0x08, 0x09} 
offset = 15 
length = 5 


code 

ArraylndexOutOfBou 

ndsException 


OxFF, OxFF }) 
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6.2.1.1.3.1.1 



Normal execution 



CRRNl: This method is used by the applet to distinguish the HCI Message command which selected this 
applet from all other HCI messages. 

CRRN2: returns true if the current HCI message caused the selection of the Applet according to the rules in 
GlobalPlatform Amendment C [10]. 



6.2.1.1.3.1.2 

• None. 

6.2.1.1.3.1.3 

• None. 

6.2.1.1.3.2 



Parameter errors 



Context errors 



Test suite files 



Applet Name 


Test case ID 


Api 2 CEm Scm l.java 


1 


Api 2 CEm Scm l.java 


2 



6.2.1.1.3.3 Initial condition 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT CARD ACTIVATED has been sent on HCI interface. 



6.2.1.1.3.4 



Test procedure 



Test case 


ID 


HCI Command API Description API Expectation HCI Response CRR 


1 


Select Applet 


EVT_SEND_DATA 
(Select applet) 


selectingMessage { ) 


No exception shall be 
thrown. 

selectingMessage()= 
true 


EVT SEND DATA (SW - 
'90 00') 


N1, 
N2 


2 


Arbitrary Command 


- EVT_SEND_DATA 
(Select applet) 
- EVT SEND DATA (INS 
= ■01') 


selectingMessage { ) 


No exception shall be 
thrown. 

selectingMessageO = 
false 


- EVT SEND DATA(SW - 
'90 00') 

- EVT SEND DATA ('01 
02 03 90 00') 


N1, 
N2 
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6.2.1.2 



Interface CardEmulationService 



6.2.1 .2.1 Method getCardRFType 

Test Area Reference: Api_2_CEs_RFt. 

6.2.1 .2.1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

byte getCardRFType { ) 

6.2.1.2.2.1.1 Normal execution 

• CRRNl : returns the reader RF type on which the service is connected, shall be one of the TYPE_* constant 
values defined in this interface, or -1 if the RF type can not be evaluated. 

• CRRN2: Applets communicating through the process() method shall also be able to use the API services 
defined in the present document which do not require a CardEmulationListener registration (e.g. requesting the 
power mode or connectivity service). 



6.2.1.2.2.1.2 

• None. 

6.2.1.2.2.1.3 

• None. 

6.2.1.2.2 



Parameter errors 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 CEs RFt Ljava 


1 


Api 2 CEs RFt Ljava 


2 


Api 2 CEs RFt Ljava 


3 


Api 2 CEs RFt Ljava 


4 



6.2.1.2.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 

6.2.1.2.3.1 Test procedure 



Test case 


ID 


HCI Command API Description 


API Expectation 


HCI Response CRR 


1 


RF type A 


EVT SEND DATA 
(INS = 'OL) 


getCardRFType { ) 


No exception sliall be thrown 
getCardRFTypeO = TYPE A CARD RF 


EVT SEND DATA 
(SW = '90 01') 


N1 
N2 


2 


RF type B 


EVT SEND DATA 
(INS = 'OL) 


getCardRFType { ) 


No exception sliall be thrown 
getCardRFTypeO = TYPE B CARD RF 


EVT SEND DATA 
(SW = '90 02') 


N1 
N2 


3 


RF type F 


EVT SEND DATA 
(INS = 'OL) 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE F CARD RF 


EVT SEND DATA 
(SW = '90 04') 


N1 
N2 


4 


RF type B' 


EVT SEND DATA 
(INS = 'OL) 


getCardRFType { ) 


No exception shall be thrown 
getCardRFTypeO = TYPE B PRIM CARD RF 


EVT SEND DATA 
(SW = '90 03') 


N1 
N2 



£75/ 



(Release 9) 



60 



ETSI TS 103 115 V9.0.0 (2013-04) 



6.2.1.3 



Interface CardEmulationListener 



6.2.1.3.1 Method onCallback 

Test Area Reference: Api_2_CEl_Ocb. 

6.2.1.3.1.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.2.1.3.1.1.1 



Normal execution 



CRRNl: The Contactless Framework shall invoke the method CardEmulationListener.onCallback only with 
events which are defined in this particular listener or CardEmulationListener and only with 
CardEmulationMessage objects. 

CRRN2: The Applet instance shall activate the events with CardEmulationService.activateEvent before it will 
receive any event notification. 

CRRN3: If the EVENT_ON_SEND_DATA is deactivated for the Applet instance the 

javacard.framework.APDU class and the process() method shall be used if the current application protocol is 
APDU based. Otherwise, if the EVENT_ON_SEND_DATA is deactivated and the current application 
protocol is not APDU based the process() method will not be invoked, i.e. the Applet will not receive any 
messages from the external reader. 

CRRN4: It shall not be possible to switch between the usage of the CardEmulationListener interface and the 
invocation through the process() method within a contactless application session, i.e. not before the Applet has 
been deselected and selected again. 



6.2.1.3.1.1.2 
• None. 



Parameter errors 



6.2.1.3.1.1.3 
• None. 



Context errors 



6.2.1.3.1.2 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 CEI Ocb Ljava 


1 


Api 2 CEI Ocb 2.java 


2 


Api 2 CEI Ocb S.java 


3 


Api 2 CEI Ocb Ljava 


4 


Api 2 CEI Ocb 2.java 


5 


Api 2 CEI Ocb 4.java 


6 


Api 2 CEI Ocb S.java 


7-1 


Api 2 CEI Ocb e.java 


7-2 


Api 2 CEI Ocb y.java 


7-3 


Api_2_CEI_Ocb_8.java 


7-4 



6.2.1.3.1.3 Initial conditions 

• EVT_FIELD_ON has been sent on HCI interface. 

• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 
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6.2.1.3.1.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


EVT_SEND_DATA - Type A 


- 


HCIListener = 


- No exception shall be 


- EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '14') 


HCIService = 






N3, 






CardEmulationService 
activateEvent ( ) 


- No exception shall be 


- EVT SEND DATA 


N4, 




EVT SEND DAT 


event = 


thrown 


(SW- '90 00') 






A(INS = '24')- 


CardEmulationListener . EVENT_ON_ 












SEND_DATA 


onCallbackO method 


- No response or no 






- deselect the 




shall notice the event 


data in the response to 






applet 




EVENT ON SEND D 


the select applet 






- select the applet 




ATA 


command 




EVENT_HCI RECEPTIONS FAILED - Type A 


2 


- 


HCIListener = 


No exception shall be 


-EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '11') 


HCIService = 




- EVT SEND DATA 


N3, 






CardEmulationService 


onCallbackO method 


(SW- '90 00') 


N4 




EVT SEND DAT 


activateEvent ( ) 


shall notice the event 


- EVT SEND DATA 






A(INS = '14') 


event = 

HCIListener . EVENT_HCI_RECEPTION 




(SW- '90 00') 






- deselect/select 


S_FAILED 




- Response to RF error 






the applet 






message not verified 






_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '11', RF 












error indicator is 












set to '01') 






- EVT SEND DATA 
(SW- '90 00') 






- deselect/select 












the applet 












EVT SEND DAT 












A(INS = '21') 










3 




EVENT GET PARAMETER RESPONSE - Type 


A 




- 


Listener = 


No exception shall be 




N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


GET PARAMETER with 


N2, 




A (INS = '01') 
- ANY_OK as 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackO shall 


the 

PARAM ID TYPE A C 


N3, 
N4, 




response to 




receive ANY OK as 


ARD_ATQA 






GET PARAMET 


prepareAndSendGetParameterComma 


EVENT GET PARAM 


- No exception after 






ER 


ndO 
paramID = 


ETER_RESPONSE 


ANY_OK reception 






- deselect/select 


PARAM_ID_TYPE_A_CARD_ATQAC 




- EVT SEND DATA 






the applet 






(SW- '90 00') 






EVT SEND DAT 






- EVT SEND DATA 






A(INS='22') 






(SW- '90 00') 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


4 


EVT_SEND_DATA - Type B 


- 


HCIListener = 


- No exception shall be 


- EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '14') 


HCIService = 






N3, 




CardEmulationService 
activateEvent ( ) 


- No exception shall be 


- EVT SEND DATA 


N4, 




EVT SEND DAT 


event = 


thrown 


(SW- '90 00') 






A(INS = '24')- 


CardEmulationListener .EVENT ON 












SEND_DATA 


onCallbackO method 


- No response or no 






- deselect the 




shall notice the event 


data in the response to 






applet 




EVENT ON SEND D 


the select applet 






- select the applet 




ATA 


command 




5 


EVENT_HCI_RECEPTIONS_FAILED - Type B 


- 


HCIListener = 


No exception shall be 


-EVT SEND DATA 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown 


(SW- '90 00') 


N2, 




A(INS = '11') 


HCIService = 




- EVT SEND DATA 


N3, 






CardEmulationService 


onCallbackO method 


(SW- '90 00') 


N4 




EVT SEND DAT 


activateEvent ( ) 


shall notice the event 


- EVT SEND DATA 






A(INS = '14') 


event = 

HCIListener . EVENT_HCI_RECEPTION 




(SW- '90 00') 






- deselect/select 


S_FAILED 




- Response to RF error 






the applet 






message not verified 






_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '11', RF 












error indicator is 












set to '01') 






- EVT SEND DATA 
(SW- '90 00') 






- deselect/select 












the applet 












EVT SEND DAT 












A(INS = '21') 










6 




EVENT_GET_PARAMETER_RESPONSE - Type 


B 




- 


Listener = 


No exception shall be 


- GET_PARAMETER 


N1, 




EVT SEND DAT 


CardEmulationListener 


thrown. 


with the 


N2, 




A (INS = '01') 
- ANY_OK as 


activateEvent ( ) 

event = 

EVENT_GET_PARAMETER_RESPONSE 


onCallbackO shall 


PARAM ID TYPE B C 
ARD_ATQB 


N3, 
N4 




response to 




receive ANY OK as 


- No exception after 






GET PARAMET 


prepareAndSendGetParameterComma 


EVENT GET PARAM 


ANY OK reception 






ER 


ndO 


ETER_RESPONSE 


- EVT SEND DATA 






- deselect/select 


paramID = 




(SW- '90 00') 






the applet 


PARAM_ID_TYPE_B_CARD_ATQB[r 










_ 






- EVT SEND DATA 






EVT SEND DAT 






(SW- '90 00') 






A(INS = '22') 










7 


Deactivate events 


1 - 


HCIService = 


No exception shall be 


EVT SEND DATA (SW- 


N2 




EVT SEND DAT 


CardEmulationService 


thrown. 


'90 00') 






A(INS='11') 


Event has been successfully 
activated 


onCallbackO method 


- EVT SEND DATA 






- deselect/select 


deactivateEvent () 


shall not notice the 


(SW- '90 00') 






the applet 


event = 


event 








- 


HCIListener . EVENT_HCI_RECEPTION 




- Response to RF error 






EVT SEND DAT 


S FAILED 




message not verified 






A(INS='20', RF 












error indicator is 






- EVT SEND DATA 






set to '01') 






(SW- '90 00') 






- deselect/select 






- EVT SEND DATA 






the applet 






(SW- '90 00') 






EVT SEND DAT 












A(INS='20') 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 




2- 


HCIService = 


No exception shall be 


- ignore the first 


N2 




EVT SEND DAT 


CardEmulationService 


thrown 


response 






A(INS='12') 


Event has been successfully 
activated 


onCallbackO method 


- EVT SEND DATA 






- ANY_OK as 


deactivateEvent ( ) 


shall not notice the 


(SW- '90 00') 






response to 


event = 


event 








GET PARAMET 


CardEmulationListener .EVENT GET 




- EVT SEND DATA 






ER 


_PARAMETER_RESPONSE 




(SW- '90 00') 






- deselect/select 


prepareAndSendGetParameterComma 










the applet 


nd() 
paramID = 












PARAM_ID_TYPE_A_CARD_ATQAC 










EVT SEND DAT 












A(INS='20') 










3- 


HCIService = 


No exception shall be 


- ignore the first 


N2 




EVT SEND DAT 


CardEmulationService 


thrown 


response 






A(INS='12') 


Event has been successfully 
activated 


onCallbackO method 


- EVT SEND DATA 






- ANY_OK as 


deactivateEvent ( ) 


shall not notice the 


(SW- '90 00') 






response to 


event = 


event 








GET PARAMET 


CardEmulationListener . EVENT_GET 




- EVT SEND DATA 






ER 


_PARAMETER_RESPONSE 




(SW- '90 00') 






- deselect/select 


prepareAndSendGetParameterComma 










the applet 


nd ( ) 
paramID = 












PARAM_ID_TYPE_B_CARD_ATQBl 










EVT SEND DAT 












A(INS='20') 










4- 


HCIService = 


No exception shall be 


- EVT SEND DATA 


N2 




- 


CardEmulationService 


thrown 


(SW- '90 00') 






EVT SEND DAT 


Event has been successfully 




- EVT SEND DATA 






A(INS='14') 


activated 


onCallbackO method 


(SW- '90 00') 






- deselect 


deactivateEvent () 


shall not notice the 


- EVT SEND DATA 






/select the applet 


event = 


event 


(SW-'90 01') 






- 


CardEmulationListener .EVENT ON 










EVT SEND DAT 


SEND DATA 










A(INS='20') 











6.2.2 Package Connectivity Service 
6.2.2.1 Interface ConnectivityService 

6.2.2.1.1 Method prepareAndSendConnectivityEvent 

Test Area Reference: Api_2_CNs_Sce. 

6.2.2.1 .1 .1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendConnectivityEvent {) 

throws HCIException 
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6.2.2.1.1.1.1 



Normal execution 



CRRNl: This non-blocking method builds the HCI event EVT_CONNECTIVITY which notifies the terminal 
host that it shall send a "HCI connectivity event" as defined in TS 102 223 [7]. 

CRRN2: If the Applet wants to use proactive functionality it shall use the Connectivity Service defined above 
to send an HCI event EVT_CONNECTIVITY to the terminal, register for 

EVENT_EVENT_DOWNLOAD_HCI_CONNECTIVITY and return. All the proactive functionality of the 
UICC API defined in TS 102 241 [6] is then available to the Applet when that Applet instance is triggered 
with the processToolkitO method defined in TS 102 241 [6]. 

CRRN3: the contactless runtime environment shall bind the services defined in uicc.hci.services.connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 
service. 

CRRN4: The Contactless Framework shall only send the HCI event EVT_CONNECTIVITY or 
EVT_TRANSACTION specified by the HCI protocol [3] to an Applet instance, when it is the selected Applet, 
which is in card emulation mode or when it is in the state ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) for the reader mode. 

CRRN5: The ProactiveHandler defined in TS 102 241 [6] shall not be available when the contactless Applet is 
invoked with the callback methods defined in the present document, or when the Applet is invoked with the 
processO method of the Applet class defined in Application Programming Interface, Java Card"^ Platform [6] 
(in card emulation mode). 



6.2.2.1.1.1.2 
• None. 



Parameter errors 



6.2.2.1.1.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.1.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs See Ljava 


1 


Api 2 CNs See Ljava 


2 


Api 2 CNs See 2.java 


3 


Api 2 CNs See S.java 


4 


Api 2 CNs See 4.java 


5 


Api 2 CNs See S.java 


6 



6.2.2.1.1.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

Pipe has been created and opened to connectivity gate in the terminal host. 

EVT_FIELD_ON has been sent on HCI interface. 
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• EVT_CARD_ACTIVATED has been sent on HCI interface. 

• According applet has been successfully installed and selected using HCI interface. 



6.2.2.1.1.4 



Test procedure 



Test case 


ID 


HCI commands 


API Description API Expectation 


HCI Response 


CRR 


1 


Send HCI Connectivity Event 


-Send 


Listener = CardEmulationListener 


No exception shall be 


SW - '90 00' 


N1 




EVT_SEND_DATA 
(Select applet) 


process { ) : 
prepareAncJSencJConnectivityEvent { ) 


thrown 


HCI event 


N3 




-Send 






EVT CONNECT 






EVT SEND DATA 






IVITY sent 






(INS = '01') 










2 


HCI interface disabled 


1 - Precondition: 


Listener = CardEmulationListener 


throw HCIException 


SW - '90 00' 


CI 




Contactless 
functionality state is 


process { ) : 
prepareAndSendConnectivityEvent { ) 


with error code 
reason 


No EVT 
CONNECTIVITY 


N3 




disabled in the UICC 




HCI CURRENTLY D 


shall be sent 






as defined in 




ISABLED 








TS 102 223 [7]. 












Send on ISO 












interface: 












- Select applet 












-Send APDU (INS = 












'02') 










2 - Precondition: 


setCommunicationlnterf ace { ) API 


throw HCIException 


SW - '90 00' 


CI 




Contactless 
functionality state is 
disabled in the UICC 


method of Global Platform 
Amendment C [10] is used to disable 
HCI interface in the CRS 


with error code 

reason 

HCI CURRENTLY D 


No EVT 

CONNECTIVITY 
shall be sent 


N3 




as defined in Global 
Platform Amendment 


Listener = CardEmulationListener 
process { ) : 


ISABLED 








C Send on ISO 


prepareAndSendConnectivityEvent { ) 










interface send the 












following commands: 
- Send APDU to 
select the applet. 
-Send APDU (INS = 


setCommunicationlnterf ace { ) API 
method of Global Platform 
Amendment C [10] is used to enable 
again HCI interface 










'02') 












- Postcondition: 












Contactless 












functionality state is 












enabled again in the 












UICC as defined in 












Global Platform 












Amendment C 










3 


Wrong Precondition Connectivity Event 


Send on ISO: 


Service = ConnectivityService 


Shall throw exception 


No EVT 


N4, 




- Select applet 


Listener = ConnectivityListener 


with error code 


CONNECTIVITY 


C3 




-Send 




reason 


shall be sent 






APDU with (INS = 
'01') 


process { ) 

ConnectivityService . 
prepareAndSendConnectivityEvent { ) 


HCI CONDITIONS 
NOT_SATISFIED 






4 


No Proactive Handler 


-Send 


Service = CardEmulationService 


ProactiveHandler 


SW - '90 00' 


N5 




EVT_SEND_DATA 


Listener = CardEmulationListener 


shall not be available 








(Select applet) 

-Send 

EVT SEND DATA 


process { ) 

ProactiveHandlerSystem.getTheHandle 
r {) 










(INS = '01') 
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Test case 


ID 


HCI commands 


API Description API Expectation 


HCI Response 


GRR 


5 


No Proactive Handler onCallback 


-Send 


Service = CardEmulationService 


ProactiveHandler 


SW - '90 GO' 


N5 




EVT_SEND_DATA 
(Select applet) 
-Send 


Listener = CardEmulationListener 
activateEvent {EVENT_ON_SEND_DATA) 
during the installation 


shall not be available 








EVT SEND DATA 


onCallback {) 










(INS = '01') 


ProactiveHandlerSystem.getTheHandle 
r{) 








6 


Use proactive functionality 


-Send 


Listener = CardEmulationListener 


No exception shall be 


- SW - '90 00' 


N1 




EVT_SEND_DATA 

(Select applet) 

-Send 

EVT SEND DATA 


process { ) : 

prepareAndSendConnectivityEvent { ) 
register for 

EVENT_EVENT_DOWNLOAD_HCI_CONNECTIVI 
TY 


thrown 


- HCI event 
EVT CONNECT 
IVITY sent 


N2N3 




with INS = '01' 












- Send ENVELOPE 


processToolkit { ) : 




- response to 






(HCI Connectivity) 
on ISO interface 


use arbitrary method of the UICC 
API {TS 102 241 [S] ) 




ENVELOPE 






after receiving HCI 












Connectivity Event 











6.2.2.1 .2 Method prepareAndSendTransactionEvent(byte[] aid, short aidOffset, 

short aidLen, byte[] parameters, short parametersOffset, short parametersLen) 

Test Area Reference: Api_2_CNs_Ste. 



6.2.2.1.2.1 



Conformance requirements 



The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendTransactionEvent {byte [] aid, 

short aidOffset, 

short aidLen, 

byte[] parameters, 

short parametersOffset, 

short parametersLen) 

throws HCIException 

j ava . lang . ArraylndexOutOf BoundsException, 
Java . lang.NullPointerException 



6.2.2.1.2.1.1 



Normal execution 



CRRNl: this non-blocking method builds the HCI event EVT_TRANS ACTION which notifies the terminal 
host that it shall launch an application on the terminal which is associated to an Applet in the UICC host 
identified. 

CRRN2: the contactless runtime environment shall bind the services defined in uicc.hci. services. connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 
service. 

CRRN3: The Contactless Framework shall only send the HCI event EVT_CONNECTIVITY or 
EVT_TRANSACTION specified by the HCI protocol [3] to an Applet instance, when it is the selected Applet, 
which is in card emulation mode or when it is in the state ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) for the reader mode. 



6.2.2.1.2.1.2 



Parameter errors 



CRRPl: throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
AID is not compliant to TS 102 622 [3]. 

CRRP2: throw Java. lang. ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 
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• CRRP3: throw java.lang.NullPointerException - if parameters is null. 

6.2.2.1 .2.1 .3 Context errors 

• CRRCl : throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

• CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

• CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs Ste l.java 


1 


Api 2 CNs Ste l.java 


2 


Api 2 CNs Ste 4.java 


3 


Api 2 CNs Ste 2.java 


4 


Api 2 CNs Ste S.java 


5 



6.2.2.1.2.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

Pipe has been created and opened to connectivity gate in the terminal host. 

EVT_FIELD_ON has been sent on HCI interface. 

EVT_CARD_ACTIVATED has been sent on HCI interface. 

According applet has been successfully installed and selected using HCI interface. 

6.2.2.1.2.4 Test procedure 



Test case 


ID 


HCI commands API Description API Expectation 


HCI Response GRR 


1 


Send HCI Transaction Event 


Send 


extends CardEmulationListener 


No exception shall be 


EVT SEND DA 


N1, 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


thrown 


TA (SW - '90 00') 

HCI event 
EVT TRANSAC 
TION sent 


N2, 
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Test case 


ID 


HCI commands 


API Description 


API Expectation HCI Response CRR 


2 


HCI interface disabled 


1 - Precondition: 


extends CardEmulationListener 


throw HCIException with 


SW - '90 00' 


CI 




Contactless 
functionality state 


process ( ) : 
prepareAndSendTransactionEvent ( ) 


error code reason 

HCI CURRENTLY DISA 


No EVT 
CONNECTIVITY 






is disabled in the 




BLED 


shall be sent 






UICC as defined 












in TS 102 223 [7]. 
Send on ISO 












interface: 












- Send APDU to 












select the applet 
- Send APDU 












(INS = '02') 










2 - Precondition: 
Contactless 
functionality state 
is disabled in the 


setCommunicationlnterf ace ( ) API 
method of Global Platform Amendment 
C [10] is used to disable HCI 
interface 


throw HCIException with 
error code reason 
HCI CURRENTLY DISA 
BLED 


SW - '90 00' 
No EVT 

CONNECTIVITY 
shall be sent 


CI 




UICC as defined 
in Global 


extends CardEmulationListener 
process ( ) : 










Platform 
Amendment C 


prepareAndSendTransactionEvent () 










Send on ISO 

intprfafp QPnH 


setCommunicationlnterf ace ( ) API 










the following 
commands: 
- Send APDU to 


method of Global Platform Amendment 










C [10] is used to enable again HCI 
interface 










select the applet. 
- Send APDU 












(INS = '02') 
- Postcondition: 












Contactless 












functionality state 
is enabled again 
in the UICC as 












defined in Global 












Platform 












Amendment C 










3 


Wrong conditions 


Send on ISO: 
- Select applet 
-Send 

APDU with (INS 
= '03') 


Service = ConnectivityService 
Listener = ConnectivityListener 
process ( ) : 
prepareAndSendTransactionEvent ( ) 


throw HCIException with 
error code reason 
HCI CONDITIONS NOT 
_SATISFIED 


SW - '90 00' 
No EVT 

TRANSACTION 
shall be sent 


C3 


4 


Wrong parameters 


1 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 
Awith INS = '01' 


process ( ) : 

prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 20 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


java.lang.ArraylndexOut 
OfBoundsException 


TA (SW - '90 00') 
No EVT 

TRANSACTION 
shall be sent 


P3 


2 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 
Awith INS = '02' 


process ( ) : 

prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen =20 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


java.lang.ArraylndexOut 
OfBoundsException 


TA (SW - '90 00') 
No EVT 

TRANSACTION 
shall be sent 


P3 
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Test case 


ID 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




3 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '03' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 20 
parametersLen = 10 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 




4 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.ArraylndexOut 


TA (SW - '90 00') 


P3 




Awith INS = '04' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 2 


OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 




5 - Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.NullPointerExc 


TA (SW - '90 00') 


P3 




Awith INS = '05' 


prepareAndSendTransactionEvent ( ) 
aid = null 
aidOffset = 
aidLen = 16 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


eption 


No EVT 

TRANSACTION 
shall be sent 




6- Send 


extends CardEmulationListener 


throw 


EVT SEND DA 


P2, 




EVT SEND DAT 


process ( ) : 


java.lang.NullPointerExc 


TA (SW - '90 00') 


P3 




AINS = '06' 


prepareAndSendTransactionEvent ( ) 
aid = 'A00000000901...01' 
aidOffset = 
aidLen = 16 
parameters = null 
parametersOf f set = 
parametersLen = 10 


eption 


No EVT 

TRANSACTION 
shall be sent 




5 


Wrong Precondition Transaction Event 


-Send 


Service = ConnectivityService 


Shall throw exception 


EVT SEND DA 


N3 




EVT SEND DAT 


Listener = ConnectivityListener 




TA (SW - '90 00') 






A (INS = '01') 


process ( ) 

ConnectivityService . 
prepareAndSendTransactionEvent ( ) 




No EVT 

TRANSACTION 
shall be sent 





6.2.2.1 .3 Method prepareAndSendTransactionEvent (byte[] parameters, short 

parametersOffset, short parametersLen) 

Test Area Reference: Api_2_CNs_Stt. 

6.2.2.1.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendTransactionEvent {byte [] parameters, 

short parametersOffset, 

short parametersLen) 

throws HCIException, 

j ava . lang . ArraylndexOutOf BoundsException, 
Java . lang.NullPointerException 
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6.2.2.1.3.1.1 



Normal execution 



CRRNl: this non-blocking method builds the HCI event EVT_TRANS ACTION which notifies the terminal 
host that it shall launch an application on the terminal which is associated to an Applet in the UICC host 
identified. 

CRRN2: the contactless runtime environment shall bind the services defined in uicc.hci.services.connectivity 
to the corresponding resources (e.g. gates and pipes) specified by the HCI protocol [3] for the connectivity 
service. 



6.2.2.1.3.1.2 



Parameter errors 



• CRRPl : throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
AID is not compliant to TS 102 622 [3]. 

• CRRP2: throw java.lang.ArraylndexOutOfBoundsException - if operation would cause access of data outside 
array bounds. 

• CRRP3: throw java.lang.NullPointerException - if parameters is null. 

6.2.2.1.3.1.3 Context errors 

• CRRCl : throw HCIException with error code reason HCI_CURRENTLY_DIS ABLED if the HCI interface 
was disabled. 

• CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

• CRRC3: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the 
conditions to call this method are not satisfied. 



6.2.2.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 CNs Stt l.java 


1 


Api 2 CNs Stt l.java 


2 


Api 2 CNs Stt S.java 


3 


Api 2 CNs Stt 2.java 


4 



6.2.2.1.3.3 



Initial condition 



Prior to this test the Terminal shall have been powered on and performed the PROFILE DOWNLOAD 
procedure. 

In terminal profile set the 25th byte, 'b6' indicates that class m is supported. 

In terminal profile 5th byte, bl indicates proactive UICC: SET UP EVENT LIST. 

Pipe has been created and opened to connectivity gate in the terminal host. 

EVT_FIELD_ON has been sent on HCI interface. 

EVT_CARD_ACTIVATED has been sent on HCI interface. 

According applet has been successfully installed and selected using HCI interface. 
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6.2.2.1.3.4 



Test procedure 



Test case 


ID 


HCI commands 


API Description 


API Expectation | HCI Response 


GRR 


1 


Send HCI Transaction Event 


Send 


extends CardEmulationListener 


No exception shall be 


SW - '90 00' 


N1, N2 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransactionEvent ( ) 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 10 


thrown 


HCI event 
EVT TRANSAC 
TION sent 




2 


HCI interface disabled 


1 - Precondition: 


extends CardEmulationListener 


throw HCIException with 


SW - '90 00' 


C1 




Contactless 
functionality state 


process ( ) : 
prepareAndSendTransactionEvent ( ) 


error code reason 

HCI CURRENTLY DISA 


No EVT 
CONNECTIVITY 






is disabled in the 




BLED 


shall be sent 






UICC as defined 












in TS 102 223 [7]. 












Send on ISO 












interface: 












- Send APDU to 












select applet 












- Send APDU 












(INS = '02') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API 


throw HCIException with 


SW - '90 00' 


C1 




Contactless 


method of Global Platform Amendment 


error code reason 


No EVT 






functionality state 
Is disabled in the 


C [10] is used to disable HCI 
interface 


HCI CURRENTLY DISA 
BLED 


CONNECTIVITY 
shall be sent 






UICC as defined 
in Global 


extends CardEmulationListener 
process ( ) : 










Platform 


prepareAndSendTransactionEvent ( ) 










Amendment C 












Send on ISO 


setCommunicationlnterf ace ( ) API 










interface send 
the following 
commands: 


method of Global Platform Amendment 
C [10] is used to enable again HCI 
interface 










- Send APDU to 












select the applet. 












- Send APDU 












(INS = '02') 












- Postcondition: 












Contactless 












functionality state 












is enabled again 












in the UICC as 












defined in Global 












Platform 












Amendment C 










3 


Wrong conditions 


Send on ISO 


Service = ConnectivityService 


throw HCIException with 


SW - '90 00' 


C3 




interface: 


Listener = ConnectivityListener 


error code reason 


No EVT 






- Select applet 

- APDU data with 
INS = '03' 


process ( ) : 
prepareAndSendTransactionEvent ( ) 


HCI CONDITIONS NOT 
_SATISFIED 


TRANSACTION 
shall be sent 




4 


Wrong parameters 


1 - Send 


extends CardEmulationListener 


throw 


SW - '90 00' 


P2, 




EVT SEND DAT 
A with INS = '01' 


process ( ) : 

prepareAndSendTransactionEvent () 
parameters = '01...01' 
parametersOf f set = 20 
parametersLen = 10 


java.lang.ArraylndexOut 
OfBoundsException 


No EVT 

TRANSACTION 
shall be sent 


P3 
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Test case 


ID 


HCI commands 


API Description 


API Expectation 


HCI Response 


CRR 




2 - Send 

EVT SEND DAT 

A with INS = '02' 


extends CardEmulationListener 
process ( ) : 

prepareAndSendTransactionEvent () 
parameters = '01...01' 
parametersOf f set = 
parametersLen = 2 


throw 

java.lang.ArraylndexOut 

OfBoundsException 


SW - '90 00' 
No EVT 

TRANSACTION 
shall be sent 


P2, 
P3 


3 - Send 

EVT SEND DAT 

A with INS = '03' 


extends CardEmulationListener 
process ( ) : 

prepareAndSendTransactionEvent ( ) 
parameters = null 
parametersOf f set = 
parametersLen = 10 


throw 

java.lang.NullPointerExc 

option 


SW - '90 00' 
No EVT 

TRANSACTION 
shall be sent 


P2, 
P3 



6.2.3 Package Reader Service 
6.2.3.1 Interface ReaderMessage 

6.2.3.1.1 Method restartReaderModeProcedure 

Test Area Reference: Api_2_RMm_Rrp. 

6.2.3.1.1.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 



void restartReaderModeProcedure {) 



throws HCIException 



6.2.3.1.1.1.1 



Normal execution 



CRRNl: this method sends first the HCI event EVT_END_OPERATION and then the HCI event 
EVT_READER_REQUESTED. 

CRRN2: this method is intended to recover from the following error states: 

reception of EVT_TARGET_DISCOVERED with a MULTIPLE_TARGET_STATUS . 

reception of RESP_WR_RF_ERROR. 

reception of RESP_AN Y_E_TIMEOUT. 

CRRN3: an Applet shall only be able to activate ReaderListener.EVENT_TARGET_DISCOVERED or to use 
the restartReadermodeProcedure method if it is in lifecycle state ACTIVATED. 



6.2.3.1.1.1.2 
• None. 



Parameter errors 



6.2.3.1.1.1.3 



Context errors 



• CRRCl : throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface is 
disabled. 

• CRRC2: throw HCIException with error code reason HCI_CONDITIONS_NOT_SATISFIED if the Applet is 
not ACTIVATED. 
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Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Rrp l.java 


1 


Api 2 RMm Rrp l.java 


2 


Api 2 RIVIm Rrp l.java 


3 


Api 2 RIVIm Rrp 2.java 


4 


Api_2_RMm_Rrp_2.java 


5 



6.2.3.1.1.3 



Initial condition 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

• The event ReaderListener.EVENT_TARGET_DISCOVERED has been activated in the applet. 



6.2.3.1.1.4 



Test procedure 



Test case 


ID 


HCI Command API Description API Expectation HCI Response CRR 


1 


MULTIPLE_TARGET_STATUS is received - Type A 


Send 

EVT TARGET Dl 

SCOVERED(Statu 

s = '03') 


restartReaderModeProcedure ( ) 

event = EVT_END_OPERATION 
event = EVT_READER_REQUESTED 


No exception shall 
be thrown 


EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 


2 


MULTIPLE_TARGET_STATUS is received - Type B 


Send 

EVT TARGET Dl 

SCOVERED(Statu 

s = '03') 


restartReaderModeProcedure ( ) 

event = EVT_END_OPERATION 
event = EVT_READER_REQUESTED 


No exception shall 
be thrown 


EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 


3 


RESP_WR_RF_ERROR is received 


-Send 

EVT TARGET Dl 

SCOVERED 

(status = '00') 

-WR_RF_ERROR 


- prepareAndSendWriteXchgDataCommand ( ) 
timeout = -1 

data = 'OI...O1' 
offset = 
len = 10 

- restartReaderModeProcedure ( ) 
event = EVT END OPERATION 
event = EVT READER REQUESTED 


No exception shall 
be thrown 


WR_XCHG_DATA 

EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 


4 


RESP ANY E TIMEOUT is received 


-Send 

EVT TARGET Dl 

SCOVERED 

(status = '00') 

ANY_E_TIMEOUT 


- prepareAndSendWriteXchgDataCommand ( ) 
timeout = -1 

data = 'OI...O1' 
offset = 
len = 10 

- restartReaderModeProcedure ( ) 
event = EVT_END_OPERATION 
event = EVT_READER_REQUESTED 


No exception shall 
be thrown 


WR_XCHG_DATA 

EVT END OPER 
ATION 

EVT READER R 
EQUESTED 


N1, 
N2, 
N3 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


GRR 


5 


HCI interface is disabled 


1 - Precondition: 


restartReaderModeProcedure ( ) 


Shall throw 


- SW - '90 03' 


CI 




Contactless 




uicc.hci.framework. 


No 






functionality state 
is disabled in the 


event = EVT END OPERATION 
event = EVT_READER_REQUESTED 


HCIException with 
error code 


EVT READER R 
EOUESTED shall 






UICC as defined 




HCI CURRENTLY 


be sent 






in TS 1 02 223 [7] 




DISABLED 








- Send APDU to 












select the applet. 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '03') 












- Send APDU on 












ISO interface ('01') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API method of 


Shall throw 


- SW - '90 03' 


CI 




Contactless 


Global Platform Amendment C [10] is used 


uicc.hci.framework. 


No 






functionality state 


to disable HCI interface 


HCIException with 


EVT READER R 






is disabled in the 


- restartReaderModeProcedure ( ) 


error code 


EOUESTED shall 






UICC as defined 




HCI CURRENTLY 


be sent 






in Global Platform 


event = EVT_END_OPERATION 


DISABLED 








Amendment C 


event = EVT_READER_REQUESTED 










Send on ISO 












interface send the 


setCommunicationlnterf ace ( ) API method of 










following 
commands: 


Global Platform Amendment C [10] is used 










to enable again HCI interface 










-Send 












EVT TARGET Dl 












SCOVERED 












(status = '03') 












- Send APDU on 












ISO interface ('01') 












- Postcondition: 












Contactless 












functionality state 












is enabled again in 












the UICC as 












defined in Global 












Platform 












Amendment C 











6.2.3.1 .2 Method prepareAndSendWriteXchgDataCommand 

Test Area Reference: Api_2_RMm_Srx 

6.2.3.1.2.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendWriteXchgDataCommand {byte timeout, 

byte [] data, 

short offset, 

short len) 

throws HCIException, 

Java . lang.NullPointerException, 

Java . lang. ArraylndexOutOfBoundsException, 

j avacard . f rameworlc . SystemException 
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6.2.3.1.2.1.1 



Normal execution 



• CRRNl: this non-blocking method builds the HCI command WR_XCHG_DATA with the data passed in the 
parameter data and sends it to the Contactless Reader Gate of the CLF. 

• CRRN2: The response data from the CLF will be transferred to the UICC with the event 
ReaderListener.EVENT_WRITE_EXCHANGE_DATA_RESPONSE. 

• CRRN3: to be able to receive and send messages over the contactless interface in reader mode the applet shall 
activate the ReaderListener.EVENT_TARGET_DISCOVERED. 

• CRRN4: an Applet has to be in the selectable state (according to the Java Card'"^ specification [11], [12] and 
[13]) to act as a contactless Applet in reader mode. 

6.2.3.1.2.1.2 Parameter errors 

• CRRPl : throw java.lang.NuUPointerException if data is null. 

• CRRP2: throw java.lang.ArraylndexOutOfBoundsException if operation would cause access of data outside 
array bounds. 

• CRRP3: throw javacard. framework. SystemException with the error code ILLEGAL_VALUE if the timeout 
value does not match with the predefined values. 



6.2.3.1.2.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 



6.2.3.1.2.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Srx l.java 


1 


Api 2 RMm Srx l.java 


2 


Api 2 RMm Srx 2.java 


3 


Api 2 RMm Srx 2.java 


4 


Api 2 RMm Srx 2.]ava 


5 


Api 2 RMm Srx 2.java 


6 


Api 2 RMm Srx 2.java 


7 



6.2.3.1.2.3 



Initial condition 



According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

The event ReaderListener.EVENT_TARGET_DISCOVERED has been activated in the applet. 



£75/ 



(Release 9) 



76 



ETSI TS 103 115 V9.0.0 (2013-04) 



6.2.3.1. 2A 



Test procedure 



Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


1 


Send Data - Type A 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


No exception shall be 


- command 


N1, 




EVT TARGET Dl 


timeout = -1 


thrown 


WR XCHG DAT 


N2, 




SCOVERED 


data = ' 01...01 ' 




A 


N3, N4 




(status = '00') 


offset = 
len = 10 




Is received 






- Send ANY OK 










2 


Send Data - Type B 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


No exception shall be 


- command 


N1, 




EVT TARGET Dl 


timeout = -1 


thrown 


WR XCHG DAT 


N2, 




SCOVERED 


data = ' 01...01' 




A 


N3, N4 




(status = '00') 


offset = 
len = 10 




Is received 






- Send ANY OK 










3 


HCI Interface Is disabled 


1 - Precondition: 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


-SW-'90 01' 


C1 




Contactless 


timeout = 14 


uicc.hci.framework.HClEx 








functionality 
stateis disabled in 


data = '01...01' 
offset = 
len = 10 


ception with error code 
HCI CURRENTLY DISA 








the UICC as 




BLED 








defined in TS 102 












223 [7] 












- Send APDU on 












ISO interface to 












select tlie applet 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 
= •11') 










2 - Precondition: 


setCommunicationlnterf ace { ) API method 


Shall throw 


-SW-'90 01' 


C1 




Contactless 


of Global Platform Amendment C [10] 


uicc.hci.framework.HClEx 








functionality state 


is used to disable HCI interface 


ception with error code 








is disabled in the 


prepareAndSendWriteXchgDataCommand { ) 


HCI_CURRENTLY_DISA 








UICC as defined 


timeout = 14 


BLED 








in Global Platform 


data = ' 01...01 ' 










Amendment C 


offset = 










Send on ISO 


len = 10 










interface send the 












following 
commands: 


setCommunicationlnterf ace { ) API method 










of Global Platform Amendment C [10] 










is used to enable again HCI interface 










- Send APDU on 












ISO interface to 












select the applet 












-Send 












EVT TARGET Dl 












SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 












= •01') 












- Postcondition: 












Contactless 












functionality state 












is enabled again in 












the UICC as 












defined in Global 












Platform 












Amendment C 
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Test case 


ID 


HCI Command 


API Description API Expectation 


HCI Response 


CRR 


4 


Data is null 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


- SW - '90 02' 


PI 




ISO interface (INS 

= '02') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = null 
offset = 
len = 10 


java.lang.NullPointerExce 
ption 








SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface ('12') 










5 


ArraylndexOutOfBounds Exception 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw java.lang. 


- SW - '90 03' 


P2 




ISO interface (INS 

= '03') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = '01...01' 
offset = -1 
len = 10 


Array IndexOutOfBoundsE 
xception 








SCOVERED 












(status = 00) 












- Send APDU on 












ISO interface ('13') 










6 


ArraylndexOutOfBounds Exception 


- Send APDU on 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw java.lang. 


- SW - '90 04' 


P2 




ISO interface (INS 

= '03') 

-Send 

EVT TARGET Dl 


timeout = 14 
data = ' 01...01' 
offset = 
len = 11 


Array IndexOutOfBoundsE 
xception 








SCOVERED 












(status = '00') 












- Send APDU on 












ISO interface (INS 












= '13') 










7 


Timeout has illegal value 


-Send 


prepareAndSendWriteXchgDataCommand { ) 


Shall throw 


- SW - '90 05' 


P3 




EVT TARGET Dl 


timeout = -2 


uicc.hci.framework.HClEx 








SCOVERED 

(status = 00) 


data = ' 01...01 ' 
offset = 
len - 10 


ceptlon with error code 
ILLEGAL VALUE 








- Send APDU on 












ISO interface (INS 












= '01') 











6.2.3.1.3 Method prepareAndSendGetParameterCommand 

Test Area Reference: Api_2_RMm_Sgp. 

6.2.3.1.3.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void prepareAndSendGetParameterCommand {byte paramid) 

throws HCIException, 

j avacardf ramework . SystemException 



6.2.3.1.3.1.1 



Normal execution 



• CRRN 1 : This non-blocking method builds the HCI command ANY_GET_PARAMETER for the indicated 
information and sends it to the Contactless Reader Gate of the CLF. 

• CRRN2: this method should only be called when the CLF has successfully discovered a card in the field, 
i.e. after reception of the HCI event EVT_TARGET_DISCOVERED. 

• CRRN3: paramid shall be one of the PARAM_* values defined in this interface. 
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6.2.3.1.3.1.2 



Parameter errors 



CRRPl: throwjavacard.framework.SystemException - with the following reason code ILLEGAL_VALUE if 
the paramID does not match with the predefined values. 



6.2.3.1.3.1.3 



Context errors 



CRRCl: throw HCIException with error code reason HCI_CURRENTLY_DISABLED if the HCI interface 
was disabled. 

CRRC2: throw HCIException with error code reason HCI_RESOURCES_NOT_AVAILABLE if the 
contactless framework does not have enough resources to process the command. 

CRRC3: throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message. 



6.2.3.1.3.2 



Test suite files 



Applet Name 


Test case ID 


Api 2 RMm Sgp l.java 


1 


Api 2 RIVIm Sgp l.java 


2 


Api 2 RIVIm Sgp 2.java 


3 


Api 2 RIVIm Sgp 2.java 


4 


Api 2 RMm Sgp 2.java 


5 



6.2.3.1.3.3 



Initial condition 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

• The event ReaderListener.EVENT_TARGET_DISCOVERED has been activated in the applet. 



6.2.3.1.3.4 



Test procedure 



Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


CRR 


1 




Get Parameter: Type 


A 






1 - Send APDU on ISO 


prepareAnciSenciGetParameterCommanci ( ) 


No exception shall 


- 


N1, 




interface (INS = '01') 


paramici = PARAM_ID_TYPE_A_READER_UID 


be thrown 


GET PARAMETE 


N2, 




-Send 

EVT TARGET DISCO 
VERED (status = '00') 
- Send APDU on ISO 


Response receiveci: 

onCallbackO 

event = EVENT_GET_PARAMETER_RESPONSE 




R with the 
predefined 
parameter value 
- APDU-Response 


N3 




interface (INS = '20') 






'0100' 




2 - Send APDU on ISO 


prepareAnciSenciGetParameterCommanci ( ) 


No exception shall 


- 


N1, 




interface (INS = '02') 
-Send 


paramici 
PARAM_ID_TYPE_A_READER_ATQA 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 
VERED (status = '00') 
- Send APDU on ISO 


Response receiveci: 

onCallbackO 

event = EVENT GET PARAMETER RESPONSE 




predefined 
parameter value 
- APDU-Response 






interface (INS = '20') 






'0200' 




3 - Send APDU on ISO 


prepareAnciSenciGetParameterCommanci ( ) 


No exception shall 


- 


N1, 




interface (INS = '03') 
-Send 


paramici 
PARAM_ID_TYPE_A_READER_APPLICATION_DA 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 






predefined 






VERED (status = '00') 
- Send APDU on ISO 


Response receiveci: 
onCallback () 




parameter value 
- APDU-Response 






interface (INS = '20') 


event = EVENT GET PARAMETER RESPONSE 




'0300' 
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Test case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response 


GRR 




4 - Send 


prepareAnciSenciGetParameterCommanci ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 
VERED (status = '00') 


paramici 
PARAM_ID_TYPE_A_READER_SAK 


be thrown. 


GET_PARAMETE 
R with the 


N2, 
N3 




- Send APDU on ISO 
interface (INS = '20') 


Response receiveci: 

onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




predefined 
parameter value 
- APDU-Response 
'0400' 




5 - Send 


- prepareAnciSenciGetParameterCommanci ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 
VERED (status = '00') 


paramici 
PARAM_ID_TYPE_A_READER_FWI 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




- Send APDU on ISO 
interface (INS = '20') 


Response receiveci: 

onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




predefined 
parameter value 
- APDU-Response 
'0500' 




6 - Send 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




EVT TARGET DISCO 
VERED (status = '00') 


paramid 
PARAM_ID_TYPE_A_READER_DATARATE_MAX 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




- Send APDU on ISO 
interface (INS = '20') 


Response received: 

onCallback () 

event = EVENT_GET_PARAMETER_RESPONSE 




predefined 
parameter value 
- APDU-Response 
'0600' 




2 




Get Parameter: Type 


B 






1 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '07') 
-Send 


paramid 
PARAM_ID_TYPE_B_READER_PUPI 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 
VERED (status = '00') 
- Send APDU on ISO 


Response received: 

onCallback 

event = EVENT GET PARAMETER RESPONSE 




predefined 
parameter value 
- APDU-Response 






interface (INS = '20') 






'0700' 




2 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '08') 
-Send 


paramid 
PARAM_ID_TYPE_B_READER_APPLICATION_DA 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 






predefined 






VERED (status = '00') 
- Send APDU on ISO 


Response received: 
onCallback () 




parameter value 
- APDU-Response 






interface (INS = '20') 


event = EVENT GET PARAMETER RESPONSE 




'0800' 




3 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = '09') 
-Send 


paramid 
PARAM_ID_TYPE_B_READER_AFI 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 
VERED (status = '00') 
- Send APDU on ISO 


Response received: 

onCallback 

event = EVENT GET PARAMETER RESPONSE 




predefined 
parameter value 
- APDU-Response 






interface (INS = '20') 






'0900' 




4 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = 'OA') 
-Send 


paramid 
PARAM_ID_TYPE_B_READER_HIGHER_LAYER_R 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 






predefined 






VERED (status = '00') 
- Send APDU on ISO 


Response received: 
onCallback 




parameter value 
- APDU-Response 






interface (INS = '20') 


event = EVENT GET PARAMETER RESPONSE 




'OAOO' 




5 - Send APDU on ISO 


prepareAndSendGetParameterCommand ( ) 


No exception shall 


- 


N1, 




interface (INS = 'OB') 
-Send 


paramid 
PARAM_ID_TYPE_B_READER_HIGHER_LAYER_D 


be thrown 


GET_PARAMETE 
R with the 


N2, 
N3 




EVT TARGET DISCO 






predefined 






VERED (status = '00') 
- Send APDU on ISO 


Response received: 
onCallback 




parameter value 
- APDU-Response 






interface (INS = '20') 


event = EVENT_GET_PARAMETER_RESPONSE 




'OBOO' 
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Test case 


ID 


HCI Command 


API Description 


API Expectation HCI Response CRR 


3 


HCI interface is disabled 


1 - Precondition: 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW - '90 03' 


CI 




Contactless functionality 
state is disabled in the 


paramid 
PARAM_ID_TYPE_A_READER_UID 


uicc.hci.framework. 
HCIException with 








UICC as defined in TS 




error code 








1 02 223 [7] 




HCI CURRENTLY 








- Send APDU on ISO 




DISABLED 








interface (INS = '01') 












-Send 












EVT TARGET DISCO 












VERED (status = '00') 












- Send APDU on ISO 












interface (INS = '11') 










2 - Precondition: 


setCommunicationlnterf ace ( ) API 


Shall throw 


- SW - '90 03' 


CI 




Contactless functionality 
state is disabled in the 
UICC as defined in 


method of Global Platform Amendment 
C [10] i£5 used to disable HCI 
interface 


uicc.hci.framework. 
HCIException with 
error code 








Global Platform 
Amendment C Send on 


prepareAndSendGetParameterCommand ( ) 
paramid 


HCI CURRENTLY 
DISABLED 








ISO interface send the 


PARAM_ID_TYPE_A_READER_UID 










following commands: 
- Send APDU on ISO 
interface to select the 
applet 
-Send 


setCommunicationlnterf ace ( ) API 
method of Global Platform Amendment 
C [10] is used to enable again HCI 
interface 










EVT TARGET DISCO 












VERED (status = '00') 












- Send APDU on ISO 












interface (INS = '11') 












- Postcondition: 












Contactless functionality 












state is enabled again in 












the UICC as defined in 












Global Platform 












Amendment C 










4 


The Contactless Framework is receiving fragmented HCI Message 


- Send APDU on ISO 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW - '90 04' 


C3 




interface (INS = '02') 
-Send 


paramid 
PARAM_ID_TYPE_A_READER_UID 


uicc.hci.framework. 
HCIException with 








EVT TARGET DISCO 




error code 








VERED (status = '00') 




HCI FRAGMENTE 
D MESSAGE ONG 








- Send ANY_OK as 




OING 








fragmented HCI 












Message (data length = 












supported buffer size -i- 












5 bytes, message not 












complete) 












- Send APDU on ISO 












interface (INS = '12') 










5 




The parameter has an illegs 


il value 


- Send APDU on ISO 


- prepareAndSendGetParameterCommand ( ) 


Shall throw 


- SW - '90 05' 


PI 




interface (INS = '05') 


paramid = -1 


uicc.hci.framework. 








- Send 




HCIException with 








EVT TARGET DISCO 
VERED (status = '00') 




error code 
ILLEGAL_VALUE 








- Send APDU on ISO 












interface (INS = '15') 
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6.2.3.2 



Interface ReaderListener 



6.2.3.2.1 Method onCallback 

Test Area Reference: Api_2_Rml_Ocb. 

6.2.3.2.1.1 Conformance requirements 

The method with the following header shall be compliant to its definition in the API. 

void onCallback {byte event, HCIMessage message) 



6.2.3.2.1.1.1 



Normal execution 



CRRNl: The Contactless Framework shall invoke the method ReaderListener.onCallback only with events 
which are defined in ReaderListener or HCIListener and only with ReaderMessage objects. 

CRRN2: The Applet instance shall activate the events with ReaderService.activateEvent before it will receive 
any event notification. 



6.2.3.2.1.1.2 

• None. 

6.2.3.2.1.1.3 

• None. 

6.2.3.2.1.2 



Parameter errors 



Context errors 



Test Suite Files 



Applet Name 


Test case ID 


Api 2 Rml Ocb l.java 


1 


Api 2 Rml Ocb l.java 


2 


Api 2 Rml Ocb l.java 


3 


Api 2 Rml Ocb l.java 


4 


Api 2 Rml Ocb l.java 


5 


Api 2 Rml Ocb l.java 


6 


Api 2 Rml Ocb l.java 


7 


Api 2 Rml Ocb l.java 


8 



6.2.3.2.1.3 



Initial conditions 



• According applet has been successfully installed and selected using ISO Interface and the applet is set into 
ACTIVATED state. 

• The event ReaderListener.EVENT_TARGET_DISCOVERED has been activated in the applet. 
6.2.3.2.1.4 Test procedure 



Test Case 


ID 


HCI Command 


API Description 


API Expectation 


HCI Response CRR 


1 


EVENT_TARGET_DISCOVERED - Type A 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


WR XCHG DAT 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


A ('00 01 00 00') 


N2 




- select applet APDU (INS = '10') 


event = 

EVENT TARGET DISCOVERED 


onCallbackQ 


is received 






-Send 




method shall notice 








EVENT TARGET DISCOVERE 




the event 








D (status = '00') 
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Test Case 


ID HCI Command API Description API Expectation 


HCI Response 


CRR 


EVENT_WRITE_EXCHANGE_DATA_RESPONSE - Type A 


2 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


Start bulk data 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


transfer on HCI 


N2 




- select applet APDU(INS = '11') 


event = 

EVENT WRITE EXCHANGE DATA RES 


onCallbackQ 


interface. 






-Send 


PONSE 


method shall notice 








EVT TARGET DISCOVERED 




the event 








(status = '00') 












- Send ANY OK () 










HCIListener.EVENT_HCI_TRANSMISSION_FAILED - Type A 


3 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


-No 


N1, 




to select applet. 

-select applet APDU (INS = '12') 

-Send 


activateEvent ( ) 

event = 

HCIListener.EVENT HCI TRANSMI 


be thrown. 
onCallbackQ 


WR_XCHG_DAT 
A is received. 


N2. 




EVT TARGET DISCOVERED 


SSION FAILED 


method shall notice 


- SW - '90 00' 






(status = '00') 




the event 








- Send ANY_OK ('1 1 22 33 44 












00'), RF error indicator is set to 

'01' 

- Send APDU (INS = '2') on ISO 






















interface 










EVENT_GET_PARAMETER_RESPONSE - Type A 


4 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


ANY GET PAR 


N1, 




to select applet. 




be thrown. 


AMETER is 


N2 




- select applet APDU(INS = '13') 
-Send 


activateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 


onCallbackQ 


received 






EVT TARGET DISCOVERED 




method shall notice 








(status = '00') 




the event 








- Send ANY OK () 










5 


EVENT_TARGET_DISCOVERED - Type B 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


WR XCHG DAT 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


A ('00 01 00 00') 


N2 




- select applet APDU (INS = '10') 


event = 

EVENT TARGET DISCOVERED 


onCallbackQ 


is received 






-Send 




method shall notice 








EVENT TARGET DISCOVERE 




the event 








D (status = '00') 










EVENT WRITE EXCHANGE DATA RESPONSE - Type B 


6 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


Start bulk data 


N1, 




to select applet. 


activateEvent ( ) 


be thrown. 


transfer on HCI 


N2 




- select applet APDU(INS = '11') 


event = 

EVENT WRITE EXCHANGE DATA RES 


onCallbackQ 


interface. 






-Send 


PONSE 


method shall notice 








EVT TARGET DISCOVERED 




the event 








(status = '00') 












- Send ANY OK () 










HCIListener.EVENT HCI TRANSMISSION FAILED - Type B 


7 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


-No 


N1, 




to select applet. 

-select applet APDU (INS = '12') 

-Send 


activateEvent ( ) 

event = 

HCIListener.EVENT HCI TRANSMI 


be thrown. 
onCallbackQ 


WR_XCHG_DAT 
A is received. 


N2. 




EVT TARGET DISCOVERED 


SSION FAILED 


method shall notice 


- SW - '90 00' 






(status = '00') 




the event 








- Send ANY_OK ('1 1 22 33 44 












00'), RF error indicator is set to 

'01' 

- Send APDU (INS = '2') on ISO 






















interface 
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Test Case 


ID 


HCI Command API Description 


API Expectation 


HCI Response 


CRR 


EVENT GET PARAMETER RESPONSE - Type B 


8 


Send command on ISO interface 


HCIService = ReaderService 


No exception shall 


ANY GET PAR 


N1, 




to select applet. 




be thrown. 


AMETER is 


N2 




- select applet APDU(INS = '13') 

-Send 

EVT TARGET DISCOVERED 


activateEvent ( ) 

event = 

EVENT GET PARAMETER RESPONSE 


onCallbackQ 
method shall notice 


received 






(status = '00') 




the event 








- Send ANY OK () 
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Annex A (normative): 

Class, methods and tests acronyms 

A.1 HCI framework 



Class name 


Acronyms 


HCIDevice 


Hdv 


HCISevice 


HSr 


HCIMessage 


Hme 


HCIListener 


HIn 


HCIException 


Hxp 



A.1.1 Class HCIDevice 



Method name 


Acronyms 


public static HCIService getHCIService { ) 


Gsr 


public static byte getPowerMode { ) 


Gpm 


public static byte isHCIServiceAvailable { ) 


Isa 



A.1 .2 Interface HCIService 



Method name 


Acronyms 


void register {) 


Reg 


void deregisterO 


Drg 


void activateEvent { ) 


Ace 


void deactivateEvent { ) 


Dae 


void requestCallbackNotif ication { ) 


Ren 


boolean getEventNotif icationStatus {) 


Gen 



A. 1.3 Interface HCIMessage 



Method Name 


Acronyms 


boolean isHeadingO 


Mhd 


boolean isCompleteO 


Mco 


byte getType { ) 


Mty 


byte getlnstruction { ) 


Min 


short getReceiveOf f set { ) 


Mro 


short getReceiveLength { ) 


Mrl 


byte[] getReceiveBuf fer {) 


Mrb 



A. 1.4 Interface HCIListener 



Method Name 


Acronyms 


void onCallbackO 


Ocb 
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Method Name 


Acronyms 


public static void throwItO 


Trw 



A.2 

A.2.1 



HCI Services 
Package carcdemulation 



Interface Name 


Acronyms 


CardEmulationMessage 


CEm 


CardEmulationService 


CEs 



A.2.1 .1 Interface CarcJEmulationLlstener 



Method Name 


Acronyms 


void onCallbackO 


Ocb 



A.2. 1.2 Interface CarcJEmulationMessage 



Method Name 


Acronyms 


void prepareAndSendGetParameterCommand { ) 


Sgp 


void prepareAndSendSendDataEvent { ) 


Ssd 


boolean selectingMessage { ) 


Scm 



A.2. 1.3 Interface CardEmulationService 



Method Name 


Acronyms 


byte getCardRFType { ) 


Rft 



A.2. 2 Package connectivity 



Interface Name 


Acronyms 


ConnectivityMessage 


CNm 


Connect ivityService 


CNs 



A.2. 2.1 Interface ConnectivityListener 

FFS 

A.2. 2. 2 Interface ConnectivityMessage 

FFS 
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A.2.2.3 Interface ConnectivityService 



Method Name 


Acronyms 


prepareAndSendConnectivityEvent { ) 


See 


prepareAndSendTransactionEvent {byte [] aid, 

short aidOffset, short aidLen, byte [] parameters, 

short parametersOf f set , short parametersLen) 


Ste 


prepareAndSendTransactionEvent {byte [] parameters, short 
parametersOf f set , short parametersLen) 


Stt 



A.2.3 Readermode 



A.2.3.1 Interface RaederListener 



Method Name 


Acronyms 


void onCallback{) 


Ocb 



A.2.3. 2 Interface ReaderMessage 



Method Name 


Acronyms 


void prepareAndSendGetParameterCommand { ) 


Sgp 


void prepareAndSendWriteXchgDataCommand { ) 


Srx 


void restartReaderModeProcedure { ) 


Rrp 



A.2.3. 3 Interface ReaderService 

FFS 
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Annex B (normative): 
AIDs - to be reserved 

B.1 Package HCI framework 



Package name 


AID 


uicc. test. hci. framework 


AO 00 GO GO 09 00 05 FF FF FF FF 89 21 00 00 00 



B.1.1 Class HCIDevice 



Package name 


AID 


uicc.test.hci.framework. Api 1 


Hdv Gsr 


AO GO 00 00 09 00 05 FF FF FF FF 89 21 01 00 00 


uicc. test. hci. framework. Api 1 


Hdv Gpm 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 02 00 00 


uicc.test.hci.framework. Api 1 


Hdv Isa 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 00 00 



Applet name 


AID 


Api 1 Hdv Gsr l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 01 01 02 


Api 1 Hdv Gsr 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 01 02 02 


Api 1 Hdv Gpm l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 02 01 02 


Api 1 Hdv Isa l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 01 02 


Api 1 Hdv Isa 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 03 02 02 



B.1 .2 Interface HCIService 



Package name 


AID 


uicc.test.hci.framework. Api 1 Hsr Reg 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 00 00 


uicc.test.hci.framework. Api 1 Hsr Drg 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 00 00 


uicc.test.hci.framework. Api 1 Hsr Ace 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 00 00 


uicc.test.hci.framework. Api 1 Hsr Dae 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 00 00 


uicc.test.hci.framework. Api 1 Hsr Ren 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 08 00 00 


uicc.test.hci.framework. Api 1 Hsr Gen 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 00 00 



Applet name 


AID 


Api 1 Hsr Reg l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 01 02 


Api 1 Hsr Reg 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 02 02 


Api 1 Hsr Reg S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 03 02 


Api 1 Hsr Reg 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 04 04 02 


Api 1 Hsr Drg l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 01 02 


Api 1 Hsr Drg 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 05 02 02 


Api 1 Hsr Ace l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 01 02 


Api 1 Hsr Ace 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 02 02 


Api 1 Hsr Ace 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 04 02 


Api 1 Hsr Ace 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 05 02 


Api 1 Hsr Ace S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 06 02 


Api 1 Hsr Ace 8.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 06 08 02 


Api 1 Hsr Dae l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 01 02 


Api 1 Hsr Dae 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 02 02 


Api 1 Hsr Dae S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 03 02 


Api 1 Hsr Dae 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 04 02 


Api 1 Hsr Dae S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 07 06 02 


Api 1 Hsr Ren 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 08 07 02 


Api 1 Hsr Gen l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 01 02 


Api_1_Hsr_Gen_2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 09 02 02 
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B.1.3 Interface HC I Message 



Package name 


AID 


uicc.test.hci.framework. Api 1 Hme Mhd 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OA 00 00 


uicc.test.hci.framework. Api 1 Hme Mco 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OB 00 00 


uicc.test.hci.framework. Api 1 Hme Mty 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 00 00 


uicc.test.hci.framework. Api 1 Hme IVIin 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 00 00 


uicc.test.hci.framework. Api 1 Hme Mro 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OE 00 00 


uicc.test.hci.framework. Api 1 Hme Mrl 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OF 00 00 


uicc.test.hci.framework. Api 1 Hme Mrb 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 10 00 00 



Applet name 


AID 


Api 1 Hme IVIhd l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OA 01 02 


Api 1 Hme IVIco l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OB 01 02 


Api 1 Hme IVIty l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 01 02 


Api 1 Hme IVIty 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OC 02 02 


Api 1 Hme IVIin l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 01 02 


Api 1 Hme Min 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OD 02 02 


Api 1 Hme Mrl l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 OF 01 02 


Api_1_Hme_IVIrb_1 .Java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 10 01 02 



B.1.4 Interface HCIListener 



Package name 


AID 


uicc.test.hci.framework. Api 1 HIn Ocb 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 00 00 



Applet name 


AID 


Api 1 HIn Ocb l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 01 02 


Api 1 HIn Ocb 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 02 02 


Api 1 HIn Ocb S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 03 02 


Api 1 HIn Ocb 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 04 02 


Api 1 HIn Ocb 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 05 02 


Api 1 HIn Ocb e.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 11 06 02 



B.1.5 Class HCIException 



Package name 


AID 


uicc.test.hci.framework. Api 1 Hxp Trw 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 12 00 00 



Applet name 


AID 


Api 1 Hxp Trw l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 21 12 01 02 



B.2 HCI Services 

B.2.1 Package cardemulation 



Package name 


AID 


uicc.test.hci.services.cardemulation 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 00 00 00 
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B.2.1 .1 Interface CarcdEmulationListener 



Package name 


AID 


uicc.test.hci.services.cardemulation.Api 2 CEI Ocb 


AO 00 GO GO G9 GO 05 FF FF FF FF 89 25 05 00 00 



Applet name 


AID 


Api 2 CEI Ocb Ljava 


AO GO 00 00 09 00 05 FF FF FF FF 89 25 05 01 02 


Api 2 CEI Ocb 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 02 02 


Api 2 CEI Ocb S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 03 02 


Api 2 CEI Ocb 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 04 02 


Api 2 CEI Ocb 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 05 02 


Api 2 CEI Ocb e.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 06 02 


Api 2 CEI Ocb y.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 07 02 


Api 2 CEI Ocb S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 05 08 02 



B.2.1. 2 Interface CarcJEmulationMessage 



Package name 


AID 


uicc.test.hci.services.cardemulation.Api 2 CEm Sgp 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 00 00 


uicc.test.hci.services.cardemulatlon.Api 2 CEm Ssd 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 00 00 


uicc. test. hci. services. cardemulation. Api 2 CEm Scm 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 03 00 00 



Applet name 


AID 


Api 2 CEm Sgp l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 01 02 


Api 2 CEm Sgp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 02 02 


Api 2 CEm Sgp S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 03 02 


Api 2 CEm Sgp 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 04 02 


Api 2 CEm Sgp 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 05 02 


Api 2 CEm Sgp 6.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 06 02 


Api 2 CEm Sgp 7.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 07 02 


Api 2 CEm Sgp 8.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 08 02 


Api 2 CEm Sgp 9.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 09 02 


Api 2 CEm Sgp lO.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OA 02 


Api 2 CEm Sgp 1 l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OB 02 


Api 2 CEm Sgp 12.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OC 02 


Api 2 CEm Sgp 13.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 01 OD 02 


Api 2 CEm Ssd l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 01 02 


Api 2 CEm Ssd 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 02 02 


Api 2 CEm Ssd 3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 03 02 


Api 2 CEm Ssd 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 02 04 02 


Api 2 CEm Scm l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 03 01 02 



B.2.1. 3 Interface CardEmulationService 



Package name 


AID 


uicc.test.hci.services.cardemulation.Api 2 CEs RFt 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 04 00 00 












Applet name 


AID 






Api 2 CEs RFt l.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 25 04 01 02 





B.2.2 Package connectivity 



Package name 


AID 


uicc.test.hci.services.connectivity 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 00 00 00 
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B.2.2.1 Interface ConnectivityListener 

FFS 

B.2.2.2 Interface ConnectivityMessage 

FFS 

B.2.2.3 Interface ConnectivityService 



Package name 


AID 


uicc.test.hci.services.connectivity.Api 2 CNs See 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 00 00 


uicc.test.hci.services.connectivity.Api 2 CNs Ste 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 00 00 


uicc.test.hci.services.connectivity.Api 2 CNs Stt 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 03 00 00 



Applet name 


AID 


Api 2 CNs See Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 01 02 


Api 2 CNs See 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 02 02 


Api 2 CNs See S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 03 02 


Api 2 CNs See 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 04 02 


Api 2 CNs See 5.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 01 05 02 


Api 2 CNs Ste Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 01 02 


Api 2 CNs Ste 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 02 02 


Api 2 CNs Ste S.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 03 02 


Api 2 CNs Ste 4.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 02 04 02 


Api 2 CNs Stt Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 03 01 02 


Api 2 CNs Stt 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 03 02 02 


Api_2_CNs_Stt_3.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 26 03 03 02 



B.2.3 Package readermode 



Package name 


AID 


uiec.test.hci.serviees. reader 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 00 00 00 



B.2.3. 1 Interface ReaderMessage 



Package name 


AID 


uiee. test. hei.serviees. reader. Api 2 RIVIm Rrp 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 00 00 


uiec.test.hci.serviees.reader.Api 2 RMm Srx 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 00 00 


ulce.test.hei.serviees.reader.Api 2 RIVIm Sgp 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 00 00 



Applet name 


AID 


Api 2 RIVIm Rrp Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 01 02 


Api 2 RMm Rrp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 01 02 02 


Api 2 RIVIm Srx Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 01 02 


Api 2 RIVIm Srx 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 02 02 02 


Api 2 RIVIm Sgp Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 01 02 


Api 2 RIVIm Sgp 2.java 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 03 02 02 
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B.2.3.2 Interface ReaderListener 



Package name 


AID 


uicc.test.hci.services.reader.Api 2 RMI Ocb 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 04 00 00 



Applet name 


AID 


Api 2 Rml Ocb Ljava 


AO 00 00 00 09 00 05 FF FF FF FF 89 27 04 01 02 







B.2.3.3 Interface ReaderService 

FFS 
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Annex C (normative): 
Requirements 

C.1 Non-occurrence and out-of-scope requirements 
C.1.1 Package uicc.hci 



Requirement 


Reference 


A mechanism to launch an application on the terminal host that is related to the Applet running in the 


Api_2_CNs_Ste 


UICC 


Api 2 CNs Stt 


The Contactless Framework shall add the AID of the calling Applet instance to the HCI event passed 


Api 2 CNs Stt 


to the CLF 




A mechanism that allows a UICC to start a proactive session as defined in TS 102 223 [7] 


Api 2 CNs See 


Content of the buffer outside of the area which is used for the HCI message part is undefined 


Api 1 Hme IVIrb 


This method throw HCIException with error code reason HCI RESOURCES NOT AVAILABLE if 


Api 2 RIVIm Srx 


the contactless framework does not have enough resources to process the command 


Api 2 RIVIm Sgp 




Api 2 CNs See 




Api 2 CEm Ssd 




Api 2 CNs Ste 




Api 2 CNs Stt 



C. 1 .2 TS 1 02 705 prose part 



Requirement 


Reference 


To release the CLF control at the end of a transaction an Applet shall deactivate the 
ReaderListener. EVENT TARGET DISCOVERED 


4.3 


The Contactless Framework shall bind the services defined in the uicc.hci.services.cardemulation package 
to the underlying HCI resources (e.g. gates and pipes) defined by the HCI protocol as specified in [3] 


4.2 





C.2 FFS requirements 
C.2.1 Package uicc.hci 



Requirement 


Reference 


The application may use the whole receive buffer for its internal purposes. If the buffer is used for 
manipulation of sensitive data it shall be cleared by the Applet before returning to the contactless 
framework 


Api_1_Hme_IVIrb 


Throw HCIException with error code reason HCI_FRAGMENTED_MESSAGE_ONGOING if the 
Contactless Framework is still receiving a fragmented HCI Message 


Api_2_RIVIm_Srx 


Throw java.lang.ArraylndexOutOfBoundsException if operation would cause access of data outside 
array bounds 


Api_2_RIVIm_Srx 


Throws HCIException with the reason code HCI_CURRENTLY_DISABLED if the HCI interface was 
disabled 


Api 2 CEm Sgp 
Api 2 CEm Ssd 


Throw HCIException with error code reason HCI_INVALID_LENGTH if the parameter length or the 
Al D is not compliant to TS 1 02 622 [3] 


Api 2 CNs Ste 
Api 2 CNs Stt 


In the case of a fragmented incoming message this method shall return the HCI message instruction 
coded in the first part of the HCI message 


Api_1_Hme_l\/lin 


If the message is not complete then the returned value is the actual HCI message fragment length 


Api 1 Hme Mrl 


HCIException with reason code HCI_CONDITIONS_NOT_SATISFIED if one or more conditions to 
activate the event are not satisfied 


Api_1_Hsr_Ace 


All other HCI messages shall be delivered to the Applet instance in the same order as they were 
received by the Contactless Framework 


Api_1_Hln_0cb 
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C.2.2 TS 1 02 705 prose part 



Requirement 


Reference 


When the contactless interface is disabled (cf. "state of contactless functionality" in TS 102 223 [7] and 
setCommunicationlnterfaceQ API method of "GlobalPlatform Amendment C" [10]), the Contactless 
Framework shall throw an HCIException with reason code HCI CURRENTLY DISABLED 


4.1 


The Contactless Framework shall request the reader mode control on the CLF by sending the HCI events 
EVT_READER_REQUESTED and EVT_END_OPERATION according to the state of the reader mode 
Applet 


4.3 


The Contactless Framework shall resend the EVT_READER_REQUESTED to the CLF if another Applet 
instance exists with the ReaderListener.EVENT TARGET DISCOVERED event activated 


4.3 


The EVT_READER_REQUESTED shall be sent by the Contactless Framework if an Applet instance 
activates the event ReaderListener.EVENT_TARGET_DISCOVERED and no other Applet instance has the 
event activated, i.e. it shall not be sent if the Contactless Framework has earlier sent an 
EVT READER REQUESTED due to the request from another Applet instance, which was not yet ended 
byanEVT END OPERATION 


4.3 


The Contactless Framework shall ensure that the ReaderListener.EVENT_TARGET_DISCOVERED is 
deactivated for all Applets when access to the interface is disabled on the UICC level 


4.3 


To be able to receive and send messages over the contactless interface in reader mode the applet shall 
activate the ReaderListener.EVENT TARGET DISCOVERED 


4.3 


When an Applet lifecycle state changes from ACTIVATED to DEACTIVATED the Contactless Framework 
shall enforce that the ReaderListener.EVENT TARGET DISCOVERED is deactivated 


4.3 


The HCI event EVT_END_OPERATION shall be sent to the CLF when an Applet instance or the 
Contactless Framework deactivates the event ReaderListener.EVENT TARGET DISCOVERED 


4.3 


The Contactless Framework shall inform the Applet instance which has activated the 
ReaderListener.EVENT_TARGET_DISCOVERED when a target is discovered on one of the RF 
technologies the Applet instance is registered to with its installation parameters as specified in TS 102 226 
[9] 


4.3 


Reader mode Applets shall follow the extended lifecycle model that is defined in "GlobalPlatform 
Amendment C" [10] for contactless Applets in card emulation mode (i.e. following Application Availability 
States and the related transition rules) 


4.3 


Per RF technology there shall be only one reader mode Applet in the state ACTIVATED (according to 
"GlobalPlatform Amendment C" [10]) at any time 


4.3 


When the state of a reader mode Applet changes to lifecycle ACTIVATED (according to "GlobalPlatform 
Amendment C" [10]) the Contactless Framework shall ensure that the HCI gates and pipes are setup for 
the RF technologies that are supported by the reader mode Applet 


4.3 
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Annex D (normative): 

Test Specification for Java Card™ Platform HCI API for the 

UICC 

The source files for the HCI API for the UICC Application Programming Interface for Java CardT"^ for contactless 
Applets are contained in Annex_D_TestAppletsSourceCode.zip, which accompanies the present document. 
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Annex E (normative): 

uicc.contactless.test.util package and contactless interfaces 

The use of Java as a test scripting language is optional. However, if Java is used as the test scripting language, then the 
test descriptions shall be implemented according to annex E. 

The content of this annex is TBD. 
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Annex F (normative): 
Test Area files 



The use of Java as a test scripting language is optional. However, if Java is used as the test scripting language, then the 
test descriptions shall be implemented according to annex F. 

The content of this annex is TBD. 
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Annex G (informative): 

Core specification version information 

Unless otherwise specified, the versions of TS 102 705 [1] from which conformance requirements have been extracted 
are as follows. 



Release 



Latest version from which conformance requirements 
have been extracted 

V9.3.0 
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History 



Document history 


V9.0.0 


April 2013 


Publication 
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